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, assets, or templates directories for bundled resources.

SKILL.md requires name (1-64 chars, lowercase letters, numbers, hyphens, matching the folder name) and description (1-1024 chars describing what the skill does and when to use it). Optional fields include license, compatibility, metadata, and allowed-tools.

Skill discovery fails most often because the description uses a YAML block scalar (> or |) instead of a single-line inline string, causing the runtime to receive a literal character. Also check that the description contains enough keywords and triggers.

A skill can include scripts for executable automation, references for documentation the agent reads on demand, assets for static files used as-is, and templates for starter code the agent modifies. Each is loaded only when directed by SKILL.md.

The description must be a single-line inline string of 10-1024 characters explaining what the skill does and when to use it. It should include capabilities, triggers, and keywords users might mention, and must not use YAML block scalars.