create-agent-skills

To create Claude Code skills, define YAML frontmatter with name and description fields, then structure an XML-based body with progressive disclosure, reference linking, and organized scripts or assets to ensure reliable auto-discovery and scalable reuse across projects.

The router pattern for Claude Code skills organizes multiple skill units into a routing structure conforming to official specification. Upgrade existing skills to this pattern during audits to ensure consistent structure, discoverability, and scalable reuse across multiple projects.

Setting up slash commands and references in a Claude Skill involves linking reference files within the SKILL.md structure using progressive disclosure patterns. Add optional references, workflows, and scripts as needed to keep skills compact yet expressive while maintaining the official specification.

Yes, Claude Code skill authoring requires XML-based body sections to satisfy the official specification. These sections work alongside YAML frontmatter for name and description, enabling progressive disclosure patterns that keep skills compact yet expressive for reliable auto-discovery across projects.

The best way to audit existing Claude Code skills is checking for YAML frontmatter compliance, valid XML-based body sections, proper progressive disclosure patterns, and correct reference linking. This maintenance workflow ensures skills meet the official specification for discoverability and scalable reuse.

Claude Skills can fail auto-discovery when YAML frontmatter is incomplete or malformed, XML-based body sections are missing, or progressive disclosure patterns are improperly structured. Auditing against the official specification ensures name and description fields enable reliable discoverability across projects.