om-create-skill

Author new OM skills from a brief or split oversized SKILL.md files into layered references.

2.6k|159|Updated Mar 8, 2021
One-click install
npx skills add https://github.com/go-musicfox/go-musicfox --skill om-create-skill-go-musicfox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-create-skill
Source: https://github.com/go-musicfox/go-musicfox/tree/main/.agents/skills/om-create-skill
Command: npx skills add https://github.com/go-musicfox/go-musicfox --skill om-create-skill-go-musicfox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing or refactoring agent skills by hand often produces bloated SKILL.md files, inconsistent frontmatter, and lint failures. This Skill turns a short brief into a convention-compliant skill, or conservatively splits an oversized SKILL.md into layered references without changing behavior, and refuses to hand back output that fails the lint and completeness gate. ## Core Features & Use Cases - Author mode: Interactively interviews you for goal, trigger phrases, tracker interaction, and chain membership, then scaffolds a new skills/<name>/ directory with a router-style SKILL.md, references, and optional repo-local stub. - Split mode: Refactors an existing oversized SKILL.md by moving sections word-for-word into references/ files, preserving the frontmatter description byte-for-byte so routing never breaks. - Hard quality gate: Runs scripts/lint.sh plus split-completeness and readability checks before returning, and supports --dry-run to preview planned files. - Use Case: You say "create a skill for reviewing database migrations" — the Skill asks the few questions that matter, drafts the router body from shared templates, pushes detail into references/, and delivers a lint-clean skill ready to commit. ## Quick Start Ask the assistant to create a new om-skill for your task, or to split an existing oversized SKILL.md into references, and answer the short interview questions it poses.

Frequently Asked Questions about om-create-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new agent skill from a short description?

Invoke the skill with a free-form brief describing what the new skill should do. It interviews you about the goal, trigger phrases, tracker interaction, and chain membership, then scaffolds the SKILL.md router body, references files, and an optional repo-local stub.

How do I split a large SKILL.md into references files?

Pass the name of an existing skill under skills/ and the skill enters split mode. It maps each section to a layer, moves text word-for-word into references/, leaves one-line pointers in the body, and verifies nothing was lost via completeness checks.

When should a SKILL.md not be split into references?

Do not split skills under roughly 150 lines, skills with no dominant template or conditional branch to extract, or fragments that load on every run anyway. The skill refuses these cases and explains why, since splitting would only add a load hop.

Does splitting a skill change its routing description?

No. The frontmatter description is preserved byte-for-byte in split mode because it drives skill routing. The gate includes a diff check that fails if the description changed in any way.

What happens if the lint check fails after generating a skill?

The skill fixes the reported violation and re-runs scripts/lint.sh until it exits clean. It never hands back a skill that fails the lint, completeness, or readability gate; --dry-run shows planned files and checks without writing anything.