creating-skills

To create a router-pattern SKILL.md, run the init_skill.py script to scaffold the file with pure XML structure, essential sections, and frontmatter, then progressively add workflows and references to expand the skill's capabilities.

The router pattern is an XML-based structure for SKILL.md files that enforces frontmatter, uses essential sections for core logic, and progressively discloses detailed information through indexed references and workflow templates.

You audit an existing skill by validating its SKILL.md structure against the official router-based XML standard, checking frontmatter completeness, and running quick_validate scripts to ensure proper reference and workflow indexing.

No external dependencies are required to use the creating-skills workflow. It provides internal scripts, references, and assets to scaffold, validate, and upgrade SKILL.md files entirely within the Claude Skill framework.

The best way to upgrade to the router pattern is using the provided upgrade-to-router workflow template, which transforms existing content into pure XML structure while establishing proper frontmatter and reference indexing.

SKILL.md validation fails during a skill audit when the file lacks required frontmatter, deviates from the pure XML structure, or misses proper indexing for references and workflows required by router-pattern standards.