make-skill-template

Create a lowercase hyphenated folder containing a SKILL.md file with YAML frontmatter defining `name` and `description`, followed by markdown instructions. Optionally add scripts, references, or assets directories, then validate with the skill validation command.

Only `name` and `description` are required. The name must be 1-64 lowercase characters with hyphens matching the folder name, and the description must be 1-1024 characters explaining what the skill does and when to use it.

Discovery relies primarily on the description field. Improve it by adding specific capabilities, trigger scenarios, and keywords users might say, and confirm the name field exactly matches the folder name.

A skill may include scripts/ for executable automation, references/ for documentation the agent reads, assets/ for static files used as-is, and templates/ for starter code the agent modifies.

Failures typically come from names with uppercase letters or consecutive hyphens, descriptions under 10 characters or missing what/when detail, and body content exceeding 500 lines. The skill's checklist covers each rule.