create-skill

Create a directory containing a SKILL.md file with YAML frontmatter defining a name and description, followed by concise Markdown instructions. Keep the body under 200 lines and move detailed content into a references/ directory loaded on demand.

SKILL.md requires YAML frontmatter with name and description fields, plus a Markdown body covering the skill's purpose, when to use it, and how to use it. It should link to reference files one level deep for detailed documentation.

SKILL.md should stay under 200 lines, though up to 500 lines can still perform adequately. Longer content should be split into reference files so the agent loads details only when needed, reducing context usage by roughly 85 percent.

Write the description in third person, stating both what the skill does and when to use it, with specific keywords and triggers. Avoid vague phrases like "helps with documents" and first- or second-person phrasing.

Use gerund-form names such as processing-pdfs or analyzing-spreadsheets. Noun phrases and action-oriented names are acceptable alternatives, but avoid vague names like helper or utils and keep naming consistent across your skill collection.

Split content whenever SKILL.md exceeds 200 lines or covers multiple domains. Keep references one level deep from SKILL.md, add a table of contents to reference files over 100 lines, and avoid duplicating content between files.