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
+3 -1
@@ -210,7 +210,7 @@ file.
The following settings can be adjusted at runtime:
| Setting | Type | Description |
|----------------------------|---------|--------------------------------------------------------------------------|
|----------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `auto_continue` | boolean | Enable/disable the [Todo System](TODO-System) auto-continuation |
| `max_auto_continues` | integer | Maximum number of automatic continuations |
| `inject_todo_instructions` | boolean | Inject default todo instructions into the system prompt |
@@ -219,12 +219,14 @@ The following settings can be adjusted at runtime:
| `top_p` | float | Model top-p parameter |
| `enabled_tools` | string | Comma-separated list of enabled tools |
| `enabled_mcp_servers` | string | Comma-separated list of enabled MCP servers |
| `enabled_skills` | string | Comma-separated list of enabled [skills](Skills) (e.g. `git-master,ai-slop-remover`); `null` clears the override |
| `save_session` | boolean | Whether to auto-save sessions |
| `compression_threshold` | integer | Token threshold for session compression |
| `max_output_tokens` | integer | Maximum output tokens for the current model |
| `dry_run` | boolean | Enable/disable dry run mode |
| `function_calling_support` | boolean | Enable/disable function calling |
| `mcp_server_support` | boolean | Enable/disable MCP server support |
| `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`) |
| `stream` | boolean | Enable/disable streaming |
| `save` | boolean | Enable/disable saving responses |
| `highlight` | boolean | Enable/disable syntax highlighting |
+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 |
| `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 |
| `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 |
| `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 |
+3 -1
@@ -118,10 +118,12 @@ In addition to the global settings above, individual sessions can override the f
at runtime using the `.set` command or configured in the session's YAML file:
| 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. |
| `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. |
| `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).
+10 -2
@@ -107,7 +107,7 @@ your current context with git knowledge, frontend conventions, or any other modu
## REPL commands
| Command | Effect |
|---------------------------------------------|--------------------------------------------------------------------------------------------------|
|---------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `.skill loaded` | List currently-loaded skills in this session. |
| `.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. |
@@ -116,6 +116,8 @@ your current context with git knowledge, frontend conventions, or any other modu
| `.delete skill` | Interactive prompt to choose installed skills to delete. |
| `.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). |
| `.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
@@ -172,11 +174,17 @@ Example role that opts into a different skill set than the global default:
```markdown
---
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.
```
`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
filtered out of the response and cannot be loaded. `skill__load` rejects it with `"Skill 'X' is not enabled in this context"`.