59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
---
|
||
summary: "Skills config schema and examples"
|
||
read_when:
|
||
- Adding or modifying skills config
|
||
- Adjusting bundled allowlist or install behavior
|
||
---
|
||
# Skills Config
|
||
|
||
All skills-related configuration lives under `skills` in `~/.clawdbot/clawdbot.json`.
|
||
|
||
```json5
|
||
{
|
||
skills: {
|
||
allowBundled: ["brave-search", "gemini"],
|
||
load: {
|
||
extraDirs: [
|
||
"~/Projects/agent-scripts/skills",
|
||
"~/Projects/oss/some-skill-pack/skills"
|
||
]
|
||
},
|
||
install: {
|
||
preferBrew: true,
|
||
nodeManager: "npm" // npm | pnpm | yarn | bun
|
||
},
|
||
entries: {
|
||
"nano-banana-pro": {
|
||
enabled: true,
|
||
apiKey: "GEMINI_KEY_HERE",
|
||
env: {
|
||
GEMINI_API_KEY: "GEMINI_KEY_HERE"
|
||
}
|
||
},
|
||
peekaboo: { enabled: true },
|
||
sag: { enabled: false }
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## Fields
|
||
|
||
- `allowBundled`: optional allowlist for **bundled** skills only. When set, only
|
||
bundled skills in the list are eligible (managed/workspace skills unaffected).
|
||
- `load.extraDirs`: additional skill directories to scan (lowest precedence).
|
||
- `install.preferBrew`: prefer brew installers when available (default: true).
|
||
- `install.nodeManager`: node installer preference (`npm` | `pnpm` | `yarn` | `bun`, default: npm).
|
||
- `entries.<skillKey>`: per-skill overrides.
|
||
|
||
Per-skill fields:
|
||
- `enabled`: set `false` to disable a skill even if it’s bundled/installed.
|
||
- `env`: environment variables injected for the agent run (only if not already set).
|
||
- `apiKey`: optional convenience for skills that declare a primary env var.
|
||
|
||
## Notes
|
||
|
||
- Keys under `entries` map to the skill name by default. If a skill defines
|
||
`metadata.clawdbot.skillKey`, use that key instead.
|
||
- Changes to skills are picked up on the next new session.
|