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 ~/.agents/skills/ for personal use or .cursor/skills/ for project scope.

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

Personal skills go in ~/.agents/skills/ and apply across all projects, while project skills live in .cursor/skills/ 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 and put detailed material in separate reference files linked one level deep. This progressive disclosure keeps the context window efficient while preserving access to depth.

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