| name | cursor-skills-system |
| description | Authoring `.cursor/skills/` skill packs that the Cursor Agent and SDK can pick up. Use when adding reusable capabilities to a project (or user-global), structuring SKILL.md frontmatter, and pairing skills with the SDK via `local.settingSources`. |
| metadata | {"internal":false,"source":"https://agentskills.io/specification"} |
cursor-skills-system
Cursor follows the Agent Skills spec: drop a folder in .cursor/skills/<name>/ with a SKILL.md and the agent can invoke it on demand. The SDK loads project and user skills when local.settingSources includes the matching scope.
When to use
- Packaging reusable instructions / scripts as a named skill
- Choosing project vs user vs team scope
- Writing spec-compliant
SKILL.md frontmatter
- Structuring atomic
references/*.md for an agent to traverse
Concepts
- [[references/folder-layout]] —
.cursor/skills/<name>/SKILL.md + references/
- [[references/skill-md-frontmatter]] — required and optional fields
- [[references/skill-graph-pattern]] — Map-of-Content + atomic references with
[[wikilinks]]
- [[references/scopes]] — project, user, plugins
- [[references/sdk-integration]] — loading via
local.settingSources
Distribution
- [[references/installing-skill-packs]] —
npx skills add <repo> and bring-your-own
- [[references/internal-flag]] —
metadata.internal to hide nodes from listings
Cross-links
- Project rules — sibling
.cursor/ feature → [[../cursor-rules/SKILL]]
- Hooks — sibling
.cursor/ feature → [[../cursor-hooks/SKILL]]
- This repo is a skill pack — see the top-level
README.md and AGENTS.md.
