creating-agent-skills

To create a Claude Code skill, you need valid SKILL.md frontmatter, pure XML body structure, and one-level-deep references. This skill transforms raw requirements into structured, discoverable, and maintainable agent skills automatically.

A valid SKILL.md file requires frontmatter for discovery metadata, a pure XML body structure for instructions, and one-level-deep references. This structure supports progressive disclosure, workflow routing, and maintains skill discoverability within repositories.

You can audit existing Claude Code skills to identify structural issues, missing metadata, broken references, and weak discovery signals. This skill evaluates your SKILL.md files against the required frontmatter, XML body, and reference specifications.

Yes, you can add workflows, references, templates, scripts, and router upgrades as a Claude Code skill grows in complexity. This allows you to extend existing skills with new capabilities while maintaining valid structure and discoverability.

You need workflow routing upgrades when a Claude Code skill grows in complexity and requires better discovery signals. Router upgrades, along with reference design and script integration, help maintain structured and maintainable agent skills as functionality expands.

Yes, the skill audit checks for broken references, missing metadata, and weak discovery signals in existing skills. It validates that one-level-deep references are properly structured to support discovery, routing, and progressive disclosure.