skills.rest
durandom
durandomCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/durandom/skills --skill create-agent-skills-durandom
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
geinalageinala

docs-writer

Write, edit, and review Markdown documentation against project standards.

Official
Advanced
Mavrick91Mavrick91

skill-developer

Create and manage Claude Code skills with SKILL.md structure and validation.

Community
Advanced
treesus6treesus6
1

building-native-ui

Guide developers to build native UI for Expo Router apps.

Community
Intermediate
hirokimryhirokimry
1

prompts-extract-all

Extract embedded prompt templates from skill files into standalone markdown documents.

Community
Advanced