docs: updated enabled_skills docs to support both CSVs and lists

2026-06-03 12:27:22 -06:00
parent e768fa448b
commit 9e1ad70b08
4 changed files with 50 additions and 36 deletions
+21 -19
@@ -209,25 +209,27 @@ file.
The following settings can be adjusted at runtime: The following settings can be adjusted at runtime:
| Setting | Type | Description | | Setting | Type | Description |
|----------------------------|---------|--------------------------------------------------------------------------| |----------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `auto_continue` | boolean | Enable/disable the [Todo System](TODO-System) auto-continuation | | `auto_continue` | boolean | Enable/disable the [Todo System](TODO-System) auto-continuation |
| `max_auto_continues` | integer | Maximum number of automatic continuations | | `max_auto_continues` | integer | Maximum number of automatic continuations |
| `inject_todo_instructions` | boolean | Inject default todo instructions into the system prompt | | `inject_todo_instructions` | boolean | Inject default todo instructions into the system prompt |
| `continuation_prompt` | string | Custom continuation prompt (supports multi-word values; `null` to reset) | | `continuation_prompt` | string | Custom continuation prompt (supports multi-word values; `null` to reset) |
| `temperature` | float | Model temperature parameter | | `temperature` | float | Model temperature parameter |
| `top_p` | float | Model top-p parameter | | `top_p` | float | Model top-p parameter |
| `enabled_tools` | string | Comma-separated list of enabled tools | | `enabled_tools` | string | Comma-separated list of enabled tools |
| `enabled_mcp_servers` | string | Comma-separated list of enabled MCP servers | | `enabled_mcp_servers` | string | Comma-separated list of enabled MCP servers |
| `save_session` | boolean | Whether to auto-save sessions | | `enabled_skills` | string | Comma-separated list of enabled [skills](Skills) (e.g. `git-master,ai-slop-remover`); `null` clears the override |
| `compression_threshold` | integer | Token threshold for session compression | | `save_session` | boolean | Whether to auto-save sessions |
| `max_output_tokens` | integer | Maximum output tokens for the current model | | `compression_threshold` | integer | Token threshold for session compression |
| `dry_run` | boolean | Enable/disable dry run mode | | `max_output_tokens` | integer | Maximum output tokens for the current model |
| `function_calling_support` | boolean | Enable/disable function calling | | `dry_run` | boolean | Enable/disable dry run mode |
| `mcp_server_support` | boolean | Enable/disable MCP server support | | `function_calling_support` | boolean | Enable/disable function calling |
| `stream` | boolean | Enable/disable streaming | | `mcp_server_support` | boolean | Enable/disable MCP server support |
| `save` | boolean | Enable/disable saving responses | | `skills_enabled` | boolean | Master switch for [skills](Skills). Accepts `true`, `false`, or `null` (inside a session, `null` clears the session-level override; otherwise resets to the default `true`) |
| `highlight` | boolean | Enable/disable syntax highlighting | | `stream` | boolean | Enable/disable streaming |
| `save` | boolean | Enable/disable saving responses |
| `highlight` | boolean | Enable/disable syntax highlighting |
![set](./images/repl/set.gif) ![set](./images/repl/set.gif)
+2
@@ -58,6 +58,8 @@ The following table lists the available configuration settings and their default
| `top_p` | Default `top_p` for the preferred model | Alternative way to control the model's output diversity, affecting the <br>probability distribution of tokens | | `top_p` | Default `top_p` for the preferred model | Alternative way to control the model's output diversity, affecting the <br>probability distribution of tokens |
| `enabled_tools` | Global setting for `enabled_tools` | The tools that this role utilizes | | `enabled_tools` | Global setting for `enabled_tools` | The tools that this role utilizes |
| `enabled_mcp_servers` | Global setting for `enabled_mcp_servers` | The MCP servers that this role utilizes | | `enabled_mcp_servers` | Global setting for `enabled_mcp_servers` | The MCP servers that this role utilizes |
| `skills_enabled` | Global setting for `skills_enabled` | Master switch for [skills](Skills) under this role. Set to `false` to hide all skills |
| `enabled_skills` | Global setting for `enabled_skills` | The [skills](Skills) this role activates. Accepts either a YAML list or a comma-separated string |
| `auto_continue` | Global setting for `auto_continue` | Enable the [Todo System](TODO-System) auto-continuation for this role | | `auto_continue` | Global setting for `auto_continue` | Enable the [Todo System](TODO-System) auto-continuation for this role |
| `max_auto_continues` | Global setting for `max_auto_continues` | Maximum number of automatic continuations before stopping | | `max_auto_continues` | Global setting for `max_auto_continues` | Maximum number of automatic continuations before stopping |
| `inject_todo_instructions` | Global setting for `inject_todo_instructions` | Inject default todo tool usage instructions into the system prompt | | `inject_todo_instructions` | Global setting for `inject_todo_instructions` | Inject default todo tool usage instructions into the system prompt |
+8 -6
@@ -117,11 +117,13 @@ The following settings are available to customize the default behavior of sessio
In addition to the global settings above, individual sessions can override the following settings. These can be set In addition to the global settings above, individual sessions can override the following settings. These can be set
at runtime using the `.set` command or configured in the session's YAML file: at runtime using the `.set` command or configured in the session's YAML file:
| Setting | Default | Description | | Setting | Default | Description |
|----------------------------|-----------------------------------------|---------------------------------------------------------------------------------------------------------------| |----------------------------|-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------|
| `auto_continue` | Global `auto_continue` value | Enable the [Todo System](TODO-System) auto-continuation for this session. Overrides global and role settings. | | `auto_continue` | Global `auto_continue` value | Enable the [Todo System](TODO-System) auto-continuation for this session. Overrides global and role settings. |
| `max_auto_continues` | Global `max_auto_continues` value | Maximum number of automatic continuations before stopping. Overrides global and role settings. | | `max_auto_continues` | Global `max_auto_continues` value | Maximum number of automatic continuations before stopping. Overrides global and role settings. |
| `inject_todo_instructions` | Global `inject_todo_instructions` value | Inject default todo tool usage instructions into the system prompt. Overrides global and role settings. | | `inject_todo_instructions` | Global `inject_todo_instructions` value | Inject default todo tool usage instructions into the system prompt. Overrides global and role settings. |
| `continuation_prompt` | Global `continuation_prompt` value | Custom prompt used when auto-continuing. Overrides global and role settings. | | `continuation_prompt` | Global `continuation_prompt` value | Custom prompt used when auto-continuing. Overrides global and role settings. |
| `skills_enabled` | Global `skills_enabled` value | Master switch for [skills](Skills) in this session. `.set skills_enabled null` clears the session override. |
| `enabled_skills` | Inherited via the skill cascade | The active [skills](Skills) for this session. Accepts either a YAML list or a comma-separated string in the saved session YAML. |
For more information on the Todo System, see the [Todo System documentation](TODO-System). For more information on the Todo System, see the [Todo System documentation](TODO-System).
+19 -11
@@ -106,16 +106,18 @@ your current context with git knowledge, frontend conventions, or any other modu
## REPL commands ## REPL commands
| Command | Effect | | Command | Effect |
|---------------------------------------------|--------------------------------------------------------------------------------------------------| |---------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `.skill loaded` | List currently-loaded skills in this session. | | `.skill loaded` | List currently-loaded skills in this session. |
| `.skill load <name>` | Load a skill. Validates policy + compatibility, then refreshes the tool scope. | | `.skill load <name>` | Load a skill. Validates policy + compatibility, then refreshes the tool scope. |
| `.skill unload <name>` | Unload a loaded skill. Releases any MCP servers it pulled in. | | `.skill unload <name>` | Unload a loaded skill. Releases any MCP servers it pulled in. |
| `.edit skill <name>` | Open an existing skill in `$EDITOR` (fails if the skill doesn't exist). | | `.edit skill <name>` | Open an existing skill in `$EDITOR` (fails if the skill doesn't exist). |
| `.skill <name>` | Open the skill in `$EDITOR`. Creates a scaffolded `SKILL.md` if missing. | | `.skill <name>` | Open the skill in `$EDITOR`. Creates a scaffolded `SKILL.md` if missing. |
| `.delete skill` | Interactive prompt to choose installed skills to delete. | | `.delete skill` | Interactive prompt to choose installed skills to delete. |
| `.install skills` | Reinstall all bundled built-in skills, overwriting existing copies after confirmation. | | `.install skills` | Reinstall all bundled built-in skills, overwriting existing copies after confirmation. |
| `.install remote <git-url> --filter skills` | Install only `skills/` from a remote repo. See [Sharing Configurations](Sharing-Configurations). | | `.install remote <git-url> --filter skills` | Install only `skills/` from a remote repo. See [Sharing Configurations](Sharing-Configurations). |
| `.set skills_enabled <true\|false\|null>` | Flip the master switch at runtime. Inside a session this sets the session override; otherwise it updates the global default (`null` restores the default `true`). |
| `.set enabled_skills <csv\|null>` | Replace the global default-active skill list at runtime, e.g. `.set enabled_skills git-master,ai-slop-remover`. Use `null` to clear. |
## CLI flags ## CLI flags
@@ -172,11 +174,17 @@ Example role that opts into a different skill set than the global default:
```markdown ```markdown
--- ---
name: frontend-dev name: frontend-dev
enabled_skills: git-master, ai-slop-remover, frontend-ui-ux enabled_skills:
- git-master
- ai-slop-remover
- frontend-ui-ux
--- ---
You are a frontend specialist. You are a frontend specialist.
``` ```
`enabled_skills` accepts either a YAML list (as shown above) or a comma-separated string
(`enabled_skills: git-master,ai-slop-remover,frontend-ui-ux`). Both forms parse to the same value.
When this role is active, the model sees exactly those three skills in `skill__list`. Any other installed skill is When this role is active, the model sees exactly those three skills in `skill__list`. Any other installed skill is
filtered out of the response and cannot be loaded. `skill__load` rejects it with `"Skill 'X' is not enabled in this context"`. filtered out of the response and cannot be loaded. `skill__load` rejects it with `"Skill 'X' is not enabled in this context"`.