skill-creator

Run init_skill.py with a hyphen-case skill name and output path to generate a template directory. Then edit SKILL.md with a clear name and description, add any needed scripts, references, or assets, and package it with package_skill.py.

SKILL.md requires YAML frontmatter with name and description fields, followed by Markdown instructions. The description drives triggering, so include what the skill does and when to use it; keep the body concise and under 500 lines.

Use scripts for deterministic, repeatedly rewritten code like file converters. Use references for detailed documentation such as schemas or API guides that the agent loads only when needed, keeping SKILL.md lean.

Run package_skill.py with the skill folder path and an optional output directory. It validates frontmatter, naming conventions, and structure first, then creates a zip-based .skill file only if validation passes.

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.