Cursor Skills System

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.