creating-claude-agents
Use when creating or improving Claude Code agents. Expert guidance on agent file structure, frontmatter, persona definition, tool access, model selection, and validation against schema.
npx skills add majiayu000/claude-skill-registry --skill creating-claude-agents --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Creating Claude Code Agents - Expert Skill Use this skill when creating or improving Claude Code agents. Provides comprehensive guidance on agent structure, schema validation, and best practices for building long-running AI assistants. ## When to Use This Skill Activate this skill when: - User asks to create a new Claude Code agent - User wants to improve an existing agent - User needs help with agent frontmatter or structure - User is troubleshooting agent validation issues - User wants to understand agent format requirements - User asks about agent vs skill vs slash command differences ## Quick Reference ### Agent File Structure ```markdown --- name: agent-name description: When and why to use this agent allowed-tools: Read, Write, Bash model: sonnet agentType: agent --- # 🔍 Agent Display Name You are [persona definition - describe the agent's role and expertise]. ## Instructions [Clear, actionable guidance on what the agent does] ## Process [Step-by-step workflow the agent follows] ## Examples [Code samples and use cases demonstrating the agent's capabilities] ``` ### File Location **Required Path:** ``` .claude/agents/*.md ``` Agents must be placed in `.claude/agents/` direc
- When to Use This Skill
- Quick Reference
- Agent File Structure
- File Location
- Frontmatter Requirements
- Required Fields
- Optional Fields
- Validation Rules
- Content Format Requirements
- H1 Heading (Required)
- Persona Definition (Required for Agents)
- Content Structure
- Schema Validation
- Schema Structure
What does the creating-claude-agents skill do?
Use when creating or improving Claude Code agents. Expert guidance on agent file structure, frontmatter, persona definition, tool access, model selection, and validation against schema.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill creating-claude-agents --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.