description
What the skill does. Used by the AI to decide when to auto-invoke it. Also shown in skill listings and help text.
Type: string Content type: skills
Provider Support
Section titled “Provider Support”| Provider | Supported | Mechanism |
|---|---|---|
| amp | ✓ | yaml frontmatter key: description (required) |
| claude-code | ✓ | yaml frontmatter key: description (recommended) |
| cline | ✓ | yaml frontmatter key: description (required) — tells Cline when to use this skill, max 1024 characters |
| codex | ✓ | YAML frontmatter key: description (required — empty string triggers MissingField error; max 1024 chars enforced after whitespace normalization) |
| copilot-cli | ✓ | yaml frontmatter key: description (required per Agent Skills open standard) |
| crush | ✓ | yaml frontmatter key: description (required); documents what the skill does and when Crush should invoke it |
| cursor | ✓ | yaml frontmatter key: description (required); documents what the skill does and when to use it. |
| factory-droid | ✓ | yaml frontmatter key: description (recommended, not required) |
| gemini-cli | ✓ | yaml frontmatter key: description (required); documents what the skill does and when Gemini should use it — drives auto-invocation decisions |
| kiro | ✓ | yaml frontmatter key: description (required) |
| opencode | ✓ | yaml frontmatter key: description (required) |
| pi | ✓ | yaml frontmatter key: description (required, max 1024 chars) |
| roo-code | ✓ | yaml frontmatter key: description (required); documents what the skill does and when Roo should load it |
| windsurf | ✓ | yaml frontmatter key: description (required). Brief explanation shown to the model to help it decide when to auto-invoke the skill. Key field for automatic invocation matching. |
| zed | ✗ | not documented |