create-agent-skills

Guide designing, authoring, and evolving Claude Code Skills with SKILL.md structure.

5|3|Updated Jan 6, 2026

Search Tags:#best-practices #progressive-disclosure #skill-design #router-pattern #skill-authoring #XML-structure

Ready to run

npx skills add https://github.com/durandom/skills --skill create-agent-skills-durandom

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-agent-skills
Source: https://github.com/durandom/skills/tree/main/.claude/skills/create-agent-skills
Command: npx skills add https://github.com/durandom/skills --skill create-agent-skills-durandom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides expert guidance for creating, writing, building, and refining Claude Code Skills. It helps users understand skill structure, best practices, and how to extend skills with workflows, references, templates, and scripts.

Core Features & Use Cases

Router vs simple skill patterns: guidance on when to use a single-file skill or a router pattern with intake, routing, workflows, and references.
Structured organization: rules for SKILL.md, progressive disclosure, and where to locate workflows, references, templates, and scripts.
Lifecycle guidance: how to audit, upgrade, add components, and validate skills through testing and verification.

Quick Start

To begin, identify whether your skill will be simple or router-based, then consult the recommended structure and incrementally add workflows and references as you evolve the skill.

Frequently Asked Questions about create-agent-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I structure a Claude Code skill to keep it maintainable?▼

A router pattern in skill design separates intake, routing logic, workflows, and references into distinct components. Use this approach when your skill handles multiple complex tasks, whereas a simple single-file SKILL.md works better for focused, straightforward operations.

What is progressive disclosure when authoring skills?▼

To validate and evolve a skill, audit its existing structure, upgrade it incrementally by adding workflows or scripts, and test triggered behaviors. This lifecycle guidance ensures your skill remains robust, maintainable, and correctly structured as project requirements grow.

When should I use a router pattern versus a simple skill design?▼

To add components to a skill, locate workflows, references, templates, and scripts in their designated directories, then link them via progressive disclosure in SKILL.md. This structured organization extends functionality while keeping the main skill file under 500 lines.

What's the best way to organize skill files and components?▼

The best way to organize skill files is to keep core routing logic in SKILL.md and separate workflows, references, templates, and scripts into dedicated locations. This structured organization supports progressive disclosure and long-term maintainability.