create-skill

Create a directory containing a SKILL.md file with YAML frontmatter defining a name and description, followed by markdown instructions. Store it in ~/.cursor/skills/ for personal use or .cursor/skills/ for project sharing.

Write the description in third person, covering both what the skill does and when to use it, with specific trigger terms. Keep it under 1024 characters and avoid vague phrases like "helps with documents".

Personal skills go in ~/.cursor/skills/skill-name/ and are available across projects, while project skills live in .cursor/skills/skill-name/ and are shared with the repository. Never create skills in ~/.cursor/skills-cursor/, which is reserved for built-in skills.

Keep SKILL.md under 500 lines for optimal performance. Move detailed documentation into separate reference files linked one level deep so the agent reads them only when needed.

Add scripts for fragile or consistency-critical operations where generated code would be unreliable, such as validation or form analysis. Document required packages and make clear whether the agent should execute or read each script.