create-agent-skills

To create Claude Code skills, follow a structured template that enforces clear frontmatter, consistent naming conventions, and validation rules. This ensures reliable execution and consistent discovery for your slash commands.

The router pattern structures multi-workflow skills by directing an initial intake process to specific workflows. It uses progressive disclosure with separate references and scripts to keep the main SKILL.md file concise.

Progressive disclosure separates workflows, references, and scripts into indexed files rather than embedding everything in SKILL.md. This keeps the core skill concise while maintaining deep functionality through reference_index and workflows_index.

Required frontmatter fields for a Claude Code skill include the name and description, while optional fields provide additional metadata. Enforcing these fields ensures high-quality skills with proper validation and risk controls.

Common anti-patterns include inconsistent naming conventions, missing frontmatter validation, and failing to use progressive disclosure. Avoiding these ensures reliable behavior and maintains high-quality skills with proper risk controls.

The router pattern is primarily designed for multi-workflow skills requiring intake and routing. Simple skills may not need this structure, but applying naming conventions and frontmatter validation remains essential for consistent discovery.