make-skill-template

Create a lowercase hyphenated folder containing a SKILL.md file with YAML frontmatter defining name and description. The description must explain what the skill does and when to use it, since it drives automatic skill discovery.

Only name and description are required. Name must be 1-64 lowercase characters matching the folder name, and description must be 1-1024 characters covering capabilities and triggers. Optional fields include license, compatibility, metadata, and allowed-tools.

Discovery failures usually come from a weak description field. Add specific keywords, trigger phrases, and scenarios users might mention, and verify the name field exactly matches the folder name in lowercase with hyphens.

Add scripts for executable automation, references for documentation the agent reads on demand, and assets for static files used as-is like images or templates. Only include them when the skill's instructions actually reference those resources.

Folder names must be lowercase letters, numbers, and hyphens only, with no consecutive hyphens, and must exactly match the name field in the SKILL.md frontmatter. Validation fails if these constraints are violated.