om-skill-creator

Run init_skill.py with the skill name and output path to generate a directory containing a SKILL.md template plus example scripts, references, and assets folders. Then edit the frontmatter description and body instructions before packaging.

A 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 holds procedural guidance loaded after activation.

Run package_skill.py with the skill folder path and an optional output directory. The script validates the skill first, then creates a zip archive with a .skill extension containing all files in the proper structure.

Validation fails when frontmatter is missing name or description, the name is not kebab-case or exceeds 64 characters, the description contains angle brackets or exceeds 1024 characters, or unexpected frontmatter keys are present.

Use scripts for deterministic, repeatedly rewritten code that can execute without loading into context. Use references for documentation like schemas or API guides that the agent reads only when needed, keeping SKILL.md lean.