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