Write a new SKILL.md file with correct YAML frontmatter, routing description, and structured body sections when a user needs to create a skill from scratch. Use this for requests like "create a skill for X", "write a skill that handles Y", "I need a new skill to do Z", or when a repeated task pattern should be captured as a reusable agent procedure. Do not use for improving existing skills (use skill-refinement or skill-improver), fixing trigger descriptions only (use skill-trigger-optimization), or installing packaged skills (use skill-installer).
Creates new skills following the agent skills format: YAML frontmatter for routing metadata plus a markdown body with Purpose, When to use, Operating procedure, Output defaults, and Failure handling. The description field is routing logic—it determines whether the skill fires.
Use when:
Do NOT use when:
skill-refinement or skill-improver)skill-trigger-optimization)skill-adaptation)"This skill [verb] when [trigger] and produces [output]."
If you cannot write this sentence, the scope is wrong—narrow until it works.
premortem, gap-analysis, acceptance-criteria-hardening---