Skills
Skills
.cursor/skills/*/SKILL.md
Vendor docs
frontmatter
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| color | string |
Badge color when the skill is used as a Custom Mode. One of `default`, `green`, `cyan`, `blue`, `purple`, `magenta`, `orange`, `yellow`, `red`, or `brand`.
|
docs ↗ | ||
| description | string | yes |
Describes what the skill does and when to use it. Used by the agent to determine relevance.
|
docs ↗ | |
| disable-model-invocation | string |
When `true`, the skill is only included when explicitly invoked via `/skill-name`. The agent will not automatically apply it based on context.
|
docs ↗ | ||
| icon | string |
Icon shown on the badge when the skill is used as a Custom Mode. Defaults to a lightning icon.
|
docs ↗ | ||
| metadata | string |
Arbitrary key-value mapping for additional metadata.
|
docs ↗ | ||
| name | string | yes |
Skill identifier. Lowercase letters, numbers, and hyphens only. Must match the parent folder name.
|
docs ↗ | |
| paths | string |
Glob patterns that scope the skill to matching files. Accepts a comma-separated string or a list. When set, the skill is only surfaced when the agent works with files that match.
|
docs ↗ |