skill-creator

Run init_skill.py with a kebab-case skill name and 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 and body, customize resources, and package the result.

SKILL.md requires YAML frontmatter with name and description fields, followed by Markdown instructions. The name must be kebab-case under 64 characters, and the description must explain 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 in the proper structure.

Use scripts for deterministic, repeatable operations like file conversion that benefit from executable code. Use references for documentation Claude should load on demand, such as API specs, schemas, or detailed workflow guides.

Validation fails when required fields are missing, the name is not kebab-case, the description exceeds 1024 characters or contains angle brackets, or unexpected properties appear. Only name, description, license, allowed-tools, metadata, and compatibility are allowed.