skill-creator

Run init_skill.py with a hyphen-case skill name and output path to generate a template directory. Then edit SKILL.md with proper frontmatter and instructions, add any needed scripts or references, and package it with package_skill.py.

The description must state what the skill does and when to use it, including specific trigger scenarios, file types, or tasks. It is the primary triggering mechanism, so all when-to-use information belongs there, not in the body.

Use scripts for deterministic, repeatedly rewritten code like file conversions that can execute without loading into context. Use references for documentation Claude should read on demand, such as API specs, schemas, or detailed workflow guides.

Run package_skill.py with the skill folder path and an optional output directory. The script validates frontmatter, naming conventions, and structure first, then creates a zip-format .skill file only if validation passes.

Validation fails when frontmatter is missing name or description, the name is not hyphen-case or exceeds 64 characters, the description contains angle brackets or exceeds 1024 characters, or unexpected frontmatter keys are present.