creating-agent-skills

What problem does it solve?

This Skill helps users design, author, and refine Claude Code Skills with consistent structure and best practices, reducing ambiguity and increasing discovery.

Core Features & Use Cases

• Structured frontmatter and XML body: Enforces a predictable format for Skill units, enabling reliable discovery and execution.
• Progressive disclosure patterns: Guides users to place details in reference files, scripts, or templates to keep SKILL.md concise.
• Router vs simple-skills guidance: Helps decide when to use a router architecture and when a simple single-file skill is sufficient.
• Quality control and auditing: Provides criteria and templates for validation, testing, and iteration.

Quick Start

Start by reading the existing SKILL.md and sketching your intended structure, then create a minimal, self-contained skill or router-based skeleton following the recommended patterns.