Skip to content

Commit 633c277

Browse files
committed
docs(skill): condense BSK_REQUEST_HELP section
1 parent 493fc6c commit 633c277

2 files changed

Lines changed: 8 additions & 18 deletions

File tree

crates/bsk-cli/skill/SKILL.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -220,15 +220,10 @@ control. After a `continued` or `completed` result, issue a separate
220220
observation tool call (usually `bsk snapshot --session <id>`) before using
221221
new refs or reasoning about the post-help page state.
222222
#### Disabling request-help (unattended mode)
223-
Set `BSK_REQUEST_HELP=off` to disable `bsk request-help` entirely. This is
224-
meant for unattended / background-server deployments where a blocking
225-
human-in-the-loop overlay must never appear. When disabled, the call
226-
returns immediately with `outcome="disabled"`: no overlay is shown, nothing
227-
waits, and the command still exits 0. The variable is unset or holds any
228-
other value by default, which keeps request-help enabled.
229-
If you receive `outcome="disabled"`, do **not** retry `request-help`
230-
nobody will ever answer it. Complete the task autonomously instead, or
231-
terminate gracefully when the step genuinely requires a human.
223+
Set `BSK_REQUEST_HELP=off` on unattended servers: `bsk request-help` then
224+
returns immediately with `outcome="disabled"` (no overlay, no waiting,
225+
exit 0). Any other value keeps it enabled. If you get `disabled`, do not
226+
retry — complete the task autonomously or stop gracefully.
232227

233228
### Recording — `bsk record`
234229

skill/SKILL.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -220,15 +220,10 @@ control. After a `continued` or `completed` result, issue a separate
220220
observation tool call (usually `bsk snapshot --session <id>`) before using
221221
new refs or reasoning about the post-help page state.
222222
#### Disabling request-help (unattended mode)
223-
Set `BSK_REQUEST_HELP=off` to disable `bsk request-help` entirely. This is
224-
meant for unattended / background-server deployments where a blocking
225-
human-in-the-loop overlay must never appear. When disabled, the call
226-
returns immediately with `outcome="disabled"`: no overlay is shown, nothing
227-
waits, and the command still exits 0. The variable is unset or holds any
228-
other value by default, which keeps request-help enabled.
229-
If you receive `outcome="disabled"`, do **not** retry `request-help`
230-
nobody will ever answer it. Complete the task autonomously instead, or
231-
terminate gracefully when the step genuinely requires a human.
223+
Set `BSK_REQUEST_HELP=off` on unattended servers: `bsk request-help` then
224+
returns immediately with `outcome="disabled"` (no overlay, no waiting,
225+
exit 0). Any other value keeps it enabled. If you get `disabled`, do not
226+
retry — complete the task autonomously or stop gracefully.
232227

233228
### Recording — `bsk record`
234229

0 commit comments

Comments
 (0)