skills.rest
ari-ayvazyan
ari-ayvazyanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-agent-skills

Author and audit Claude Code Skills with structured SKILL.md and router patterns.

1|Updated Dec 20, 2025
Search Tags:#validation#workflows#references#router-pattern#skill-authoring#xml-structure
One-click install
npx skills add https://github.com/ari-ayvazyan/AISkills --skill create-agent-skills-ari-ayvazyan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent-skills
Source: https://github.com/ari-ayvazyan/AISkills/tree/main/skills/create-agent-skills
Command: npx skills add https://github.com/ari-ayvazyan/AISkills --skill create-agent-skills-ari-ayvazyan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides expert guidance on authoring, auditing, and upgrading Claude Code Skills. It explains how to structure SKILL.md, organize router-based workflows, and manage references and scripts to build robust, maintainable skill units.

Core Features & Use Cases

  • Router-pattern guidance: how to design skills with intake, routing, and dedicated workflows.
  • ** Progressive disclosure**: how to split knowledge into SKILL.md and references, workflows, and scripts.
  • Upgrade & audit workflows: provides processes like upgrade-to-router.md and audit-skill.md to keep skills current.
  • Component scaffolding: guidance on adding optional directories (scripts/, references/, assets) and how to use them in workflows.

Quick Start

Draft a new SKILL.md for a simple skill or decide to adopt the router pattern with workflows and references.

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 SKILL.md file for Claude Code?▼

The router pattern for Claude Code skills involves designing workflows with intake, routing, and dedicated execution paths. It helps manage complex skill logic by splitting knowledge into SKILL.md, references, and scripts for maintainable skill units.

What is the best way to organize references and scripts in a skill directory?▼

Organize references and scripts by adding optional directories like scripts/ and references/ within your skill. Use progressive disclosure to split knowledge, keeping SKILL.md lightweight while storing detailed information in these dedicated component folders.

Can I upgrade existing Claude Code skills to use the router pattern?▼

Yes, you can upgrade existing Claude Code skills to the router pattern using dedicated audit and upgrade workflows. These processes evaluate your current skill structure and migrate it to router-based workflows with proper intake and routing stages.

When should I use progressive disclosure when authoring skills?▼

Use progressive disclosure when authoring skills to maintain scalability across multiple workflows. It prevents SKILL.md from becoming overloaded by splitting detailed knowledge into references and scripts, keeping the core routing logic clean and maintainable.

How do I audit a Claude Code skill for best practices?▼

To audit a Claude Code skill, run a dedicated audit workflow that checks for structured frontmatter, valid XML body content, proper router-pattern adoption, and correct progressive disclosure across references and workflows.

Related Skills

Explore More Software Engineering Skills→
gsd-buildgsd-build
7.8k

create-skill

Create standardized GSD Skill units with YAML frontmatter and XML body structure.

Official
Advanced
cmetechcmetech

create-skill

Creates OTTO skills with SKILL.md frontmatter and router patterns.

Community
Advanced
Starchild-ai-agentStarchild-ai-agent
22

skill-creator

Generate skill directory structures with template SKILL.md files.

Official
Basic
nilpathnilpath

creating-agent-skills

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

Community
Advanced