create-agent-skills

Design, author, and verify Claude Code Skills using XML with YAML frontmatter.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill create-agent-skills-gerald-ica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-agent-skills
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/create-agent-skills
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill create-agent-skills-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill design guide helps you craft, audit, and evolve Claude Code Skills by providing a clear blueprint for structure, discoverability, and maintainability.

Core Features & Use Cases

  • Provides a router pattern blueprint for multi-workflow skills with inline essential principles, intake questions, routing, and references.
  • Defines progressive disclosure patterns that separate knowledge (references) from procedures (workflows) and outputs (templates/scripts).
  • Prescribes XML-based content structure to ensure parsing reliability, token efficiency, and consistent discovery across the skill ecosystem.

Quick Start

Create your first skill by writing YAML frontmatter and a minimal SKILL.md containing an objective and a quick_start.

Frequently Asked Questions about create-agent-skills

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

FAQPage Schema
How do I design and author Claude Code Skills using a structured format?

Design Claude Code Skills using an XML-based structure with mandatory YAML frontmatter. Define workflows, references, and templates across a router pattern to ensure parsing reliability, token efficiency, and consistent discovery.

What is progressive disclosure in skill design and when should I use it?

Progressive disclosure in skill design separates static reference knowledge from active procedural workflows, loading reference material only as needed. Use this pattern to maintain token efficiency and keep skill structures maintainable as complexity grows.

How do I audit and upgrade existing skills to follow a router-pattern structure?

Audit and upgrade existing skills by restructuring content into a router-pattern blueprint with inline essential principles, intake questions, and routing logic. Convert the body to pure XML and verify mandatory YAML frontmatter compliance.

Does every Claude Code Skill require YAML frontmatter and a pure XML body?

Yes, every skill requires mandatory YAML frontmatter with name and description fields, followed by a pure XML body. This structure enforces parsing reliability and consistent discoverability across the skill ecosystem.

What's the best way to organize knowledge when creating multi-workflow skills?

Organize multi-workflow skills by separating knowledge into references, procedures into workflows, and outputs into templates or scripts. Apply a router pattern to route inputs to the correct workflow dynamically.

Why use XML structure instead of markdown for Claude Code Skill content?

XML structure ensures parsing reliability, token efficiency, and consistent discovery across the skill ecosystem. Unlike markdown, pure XML provides strict boundaries that support progressive disclosure and structured routing.