skill-creator

Run scripts/init_skill.py with the skill name and output path, optionally passing --resources scripts,references,assets and --examples. It generates a skill directory with a SKILL.md template containing the required name and description frontmatter, which you then customize.

The description must state what the skill does and when to use it, including specific trigger scenarios, since it is the primary mechanism for skill discovery. Keep it under 1024 characters, avoid angle brackets, and put all when-to-use information here rather than in the body.

Run scripts/package_skill.py with the path to your skill folder and an optional output directory. It first validates the skill's frontmatter, naming, and structure, then creates a zip archive with a .skill extension if validation passes.

Skill names must use lowercase letters, digits, and hyphens only, with no leading, trailing, or consecutive hyphens, and a maximum of 64 characters. The init script normalizes names to hyphen-case, and the validator rejects names violating these rules.

Use scripts/ for executable code needing deterministic reliability, references/ for documentation loaded into context on demand, and assets/ for files used in outputs like templates or fonts. Only create the directories your skill actually needs.

Validation fails when SKILL.md is missing, frontmatter lacks name or description, unexpected YAML keys are present, the name violates hyphen-case rules, or the description exceeds 1024 characters or contains angle brackets. Fix the reported errors and rerun package_skill.py.