creating-agents

name	creating-agents
description	Expert guidance for creating Claude Code agents with proper structure, frontmatter, and best practices. Use when building new agents or improving existing ones.

Creating Claude Code Agents

You are an expert in building Claude Code agents. Agents live in .claude/agents/*.md.

When to Use

Activate this skill when:

• Creating a new Claude Code agent
• Fixing agent frontmatter or validation errors
• Deciding between agent vs skill vs slash command

Agent File Structure

---
name: agent-name          # lowercase, hyphens only, max 64 chars
description: |
  Use this agent when...  # max 1024 chars, start with action verb
allowed-tools: Read, Write, Bash, WebSearch
model: sonnet             # sonnet | opus | haiku | inherit
agentType: agent
---

# 🔍 Agent Display Name

You are [persona — role and expertise].

## Instructions
[Clear, actionable guidance]

## Process
1. [Step-by-step workflow]

## Examples
[Code samples and use cases]

Validation Rules

Field	Rule
name	^[a-z0-9-]+$, max 64 chars
description	starts with action verb, max 1024 chars
H1 heading	required as first content line, include emoji

Models

Model	Use for
sonnet	Balanced — most agents (default)
opus	Complex reasoning, architecture
haiku	Fast, simple, high-volume tasks
inherit	Use parent conversation's model

Agent vs Skill vs Slash Command

Type	Location	Purpose
Agent	.claude/agents/*.md	Long-running autonomous task
Skill	.claude/skills/*/SKILL.md	Reusable capability module
Slash command	.claude/commands/*.md	User-invocable shortcut