skill-creator

Run init_skill.py with a hyphen-case skill name to generate the directory, SKILL.md template, and example resource folders. Then edit the SKILL.md frontmatter and body, customize resources, and validate with quick_validate.py before delivery.

A SKILL.md requires YAML frontmatter with name and description fields, followed by Markdown instructions. The name must be hyphen-case under 64 characters, and the description must explain what the skill does and when to use it.

Run quick_validate.py with the skill name or absolute path. It checks that SKILL.md exists, the frontmatter parses as valid YAML, required fields are present, and naming and description length rules are satisfied.

Move content to references when SKILL.md approaches 500 lines or when details apply only to specific variants or domains. Reference files should link directly from SKILL.md with clear guidance on when to read them.

quick_validate.py only checks structural rules like frontmatter fields, naming conventions, and description length. It does not verify instruction quality, test bundled scripts, or detect broken links to reference files.