skills.rest
nilpath
nilpathCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

creating-agent-skills

Create and refine Claude Code Skills with SKILL.md structure and best practices.

Updated Jan 29, 2026
Search Tags:#claude-code#progressive-disclosure#skill-design#router-pattern#skill-authoring#xml-structure
One-click install
npx skills add https://github.com/nilpath/nilpath-marketplace --skill creating-agent-skills-nilpath
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: creating-agent-skills
Source: https://github.com/nilpath/nilpath-marketplace/tree/main/plugins/claude-code-tools/skills/create-agent-skills
Command: npx skills add https://github.com/nilpath/nilpath-marketplace --skill creating-agent-skills-nilpath

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides users through authoring, structuring, and refining Claude Code Skills, ensuring adherence to official specifications and best practices.

Core Features & Use Cases

  • Structured SKILL.md authoring: Create skills that follow YAML frontmatter and XML body consistently.
  • Progressive disclosure: Split content into references, workflows, and scripts to keep SKILL.md concise.
  • Router pattern guidance: Build skills with intake, routing, and dedicated workflows to support multiple intents.
  • Reference and workflow organization: Organize knowledge to support scalable, maintainable skills.

Quick Start

Write an initial SKILL.md that captures name, description, and minimal guidance, then add one reference file for detailed guidance.

Frequently Asked Questions about creating-agent-skills

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

FAQPage Schema
How do I create a Claude Code Skill with SKILL.md?▼

To create a Claude Code Skill, write a SKILL.md file with YAML frontmatter and an XML body. Start with a minimal description, then add a reference file for detailed guidance to keep the core file concise.

What is progressive disclosure in skill design?▼

Progressive disclosure is a skill design pattern that splits content into references, workflows, and scripts. This approach keeps SKILL.md concise while organizing detailed knowledge into scalable, maintainable reference files.

How do I build a router pattern for multiple intents in Claude Code?▼

Build a router pattern by structuring your skill with intake, routing, and dedicated workflows. This pattern supports multiple intents within a single skill by directing user requests to specific workflow files.

What's the best way to structure references in SKILL.md?▼

The best way to structure references is to separate detailed guidance from the main SKILL.md file. Organize knowledge into dedicated reference files to support scalable, maintainable skills following official specifications.

Do I need XML structure for Claude Code skill authoring?▼

Yes, XML structure is required for the body of a SKILL.md file. Consistent XML tags ensure the skill follows official specifications and best practices for Claude Code skill authoring.

Related Skills

Explore More Software Engineering Skills→
jah377jah377

create-agent-skills

Guide creation and modification of Claude Code Skills with XML structure.

Community
Advanced
EveryIncEveryInc
24.1k

create-agent-skills

Create and audit Claude Code Skills with structured SKILL.md guidance and router-based architecture.

Official
Advanced
outcomeengoutcomeeng
1

auditing-skills

Audit SKILL.md files for structural and content issues with file:line findings.

Official
Advanced
raykrayk
3

skill-builder

Guide structured creation of Claude Code skills with XML and YAML validation.

Community
Basic