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 requires YAML frontmatter with name and description fields, followed by Markdown instructions. The description drives triggering, so it must state what the skill does and when to use it; the body loads only after the skill triggers.

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-based .skill file named after the skill folder if validation passes.

Use scripts for deterministic or repeatedly rewritten code, references for documentation Claude loads on demand like schemas or API docs, and assets for files used in output such as templates, images, or fonts. Delete any directories the skill does not need.

Validation fails when frontmatter is missing or malformed, 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. Fix the reported errors and rerun the packaging script.