skill-creator

Run scripts/init_skill.py with a hyphen-case skill name and an output path. The script generates a skill directory containing a SKILL.md template with TODO placeholders plus example scripts/, references/, and assets/ folders to customize or delete.

SKILL.md must contain YAML frontmatter with a name and description field, followed by Markdown instructions. The name must be hyphen-case lowercase, and the description should explain what the skill does and when to use it.

Run scripts/package_skill.py with the path to the skill folder and an optional output directory. The script validates the skill first, then creates a zip named after the skill containing all files with proper directory structure.

Use scripts/ for executable code needing deterministic reliability, references/ for documentation loaded into context as needed, and assets/ for files used in output like templates or fonts. Not every skill needs all three directories.

Validation fails when SKILL.md is missing, frontmatter lacks name or description, the name violates hyphen-case rules, or the description contains angle brackets. Fix the reported errors and rerun package_skill.py.