creating-agent-skills

Design Claude Code Skills that adhere to the official skill specification.

Updated Aug 23, 2026

Search Tags:#best-practices #claude-skills #progressive-disclosure #skill-design #router-pattern #skill-authoring #xml-structure

Ready to run

npx skills add https://github.com/lovincyrus/claude-config --skill creating-agent-skills-lovincyrus

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create Claude Code Skills that follow the official specification, enabling consistent, high-quality skill units.

Core Features & Use Cases

Router pattern guidance: Architect skills that route multiple intents through a single SKILL.md.
** Progressive disclosure**: Structure content with SKILL.md plus referenced files to manage complexity.
References & workflows: Organize domain knowledge in references and step-by-step workflows for robust skills.
Templates & best practices: Provide standardized SKILL.md templates and examples to accelerate authoring and auditing.

Quick Start

Draft a new router-based SKILL.md for a hypothetical skill named "example-skill" and set up initial references/workflows directories.

Frequently Asked Questions about creating-agent-skills

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

FAQPage Schema

How do I design Claude Code Skills that follow the official specification?▼

To design Claude Code Skills that follow the official specification, use standardized SKILL.md templates that ensure metadata completeness and provide validation patterns to guide implementation.

What is the router pattern in skill design and when should I use it?▼

The router pattern in skill design architectures multiple intents through a single SKILL.md file. Use this approach when you need to route diverse user requests into one unified skill unit.

How do I manage complexity when authoring large Claude Skills?▼

Manage complexity when authoring Claude Skills by applying progressive disclosure, which structures content using a SKILL.md file alongside referenced files to organize domain knowledge.

What is the best way to structure references and workflows for skill authoring?▼

The best way to structure references and workflows for skill authoring is to organize domain knowledge in dedicated reference files and map step-by-step workflows to ensure robust skill execution.

Can I audit existing skill metadata for specification compliance?▼

Yes, you can audit existing skill metadata for specification compliance by applying validation patterns that check for metadata completeness and verify router patterns and XML structure.