skill-creator

Run scripts/init_skill.py with a skill name and output path to generate a template directory containing SKILL.md and example scripts, references, and assets folders. Then edit SKILL.md, customize resources, and package with package_skill.py.

The frontmatter must include a hyphen-case name and a description explaining what the skill does and when to use it. The description is the primary triggering mechanism, so include specific scenarios, file types, or tasks that activate the skill.

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

Run scripts/package_skill.py with the skill folder path and an optional output directory. The script validates the skill first, then creates a zip-based .skill file named after the skill folder 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.

Keep the SKILL.md body under 500 lines and focused on essential procedural instructions. Move detailed reference material, schemas, and examples into references files that Claude loads only when needed.