skill-creator

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

SKILL.md requires YAML frontmatter with name and description fields, followed by a Markdown body with usage instructions. The name must be hyphen-case, and the description should explain both what the skill does and when to trigger 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 containing all files.

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 schemas, API docs, or detailed workflow guides.

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.