create-skill

To create a Cursor skill, author a SKILL.md file with required YAML frontmatter including name and description fields. Follow the recommended directory layout with scripts/, references/, and assets/ folders, adding optional components as needed for your specific skill requirements.

Cursor SKILL.md frontmatter requires name and description fields in YAML format. The description must be concise with progressive disclosure, providing a clear narrative of when to use the skill for proper validation and discovery across personal and project skill repositories.

Cursor skills for personal use belong in ~/.cursor/skills/ directory, while project-specific skills reside in .cursor/skills/ within your project root. This separation enables proper skill discovery and validation across different contexts.

The recommended Cursor skill directory layout includes a root SKILL.md file with optional scripts/, references/, and assets/ subdirectories. This minimal structure supports progressive disclosure, allowing detailed guidance to be organized and accessible.

Cursor skill descriptions must be concise and use progressive disclosure. This approach provides essential context about when to use the skill upfront, with detailed guidance revealed through optional components and reference files as needed.

Validate your SKILL.md file by checking that frontmatter includes required name and description fields, the description is concise with progressive disclosure, and the directory layout follows the minimal structure with optional scripts/, references/, and assets/ folders.