skill-creator

Run init_skill.py with a hyphen-case skill name and an output path to generate a skill directory containing a SKILL.md template plus example scripts, references, and assets folders. Then edit the SKILL.md frontmatter description and replace or delete the example files.

SKILL.md must start with YAML frontmatter containing name and description fields, followed by markdown instructions. The name must be hyphen-case lowercase, and the description should explain both 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, then creates a zip archive with a .skill extension if validation passes.

Validation fails when frontmatter is missing name or description, uses unexpected keys, contains angle brackets in the description, or violates hyphen-case naming rules. Only name, description, license, allowed-tools, and metadata keys are permitted.

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