Adding Skills
Skills are slash commands defined as SKILL.md files inside skills/<skill-name>/ directories.
File Format
Create skills/my-skill/SKILL.md:
---
name: my-skill
description: >
What this skill does and when to use it.
disable-model-invocation: true
allowed-tools: Bash(dotnet *), Read, Glob, Grep
---
# My Skill
Instructions for the skill in markdown...
Frontmatter Fields
| Field | Required | Description |
|---|---|---|
name |
No | Defaults to directory name |
description |
Recommended | Drives auto-invocation |
disable-model-invocation |
No | Set true for manual-only skills |
allowed-tools |
No | Tool restrictions for this skill |
context |
No | fork to run in a forked subagent |
agent |
No | Subagent type when context: fork |
Best Practices
- Use
disable-model-invocation: truefor workflows that should only run when explicitly requested - Use
context: forkwithagent: reviewerfor read-only analysis skills - Include step-by-step instructions with pass/fail criteria
- Use
$ARGUMENTSto accept user input