skill-creator

Run the init_skill.py script with a hyphen-case skill name and output path to generate a template directory. It creates SKILL.md with frontmatter placeholders plus example scripts, references, and assets folders that you customize or delete.

SKILL.md must contain YAML frontmatter with a name and description field, followed by Markdown instructions. The name must be hyphen-case lowercase, and the description should explain what the skill does and when to use it.

Run package_skill.py with the path to your skill folder and an optional output directory. The script validates the skill first and only creates the zip archive if all frontmatter and naming checks pass.

Use scripts for deterministic, repeatedly rewritten code like file converters that can execute without loading into context. Use references for documentation Claude should read on demand, such as API specs or schemas, keeping SKILL.md lean.

Validation fails when the description contains angle brackets or when required fields are missing from the frontmatter. Check that name and description exist, the name uses only lowercase letters, digits, and hyphens, and remove any < or > characters.