---

name: agent-creator description: Create specialized Claude Code agents (subagents) with proper YAML frontmatter, tool permissions, and domain expertise. Use when: creating new agents, designing agent prompts, configuring agent tools and models. Triggers: create agent, new agent, agent template, subagent, agent design. allowed-tools: Read, Write

Agent Creator

Create specialized Claude Code agents in .claude/agents/ directory.

Template: See references/template.md for YAML structure, format rules, tools, skills, models, color, and examples.

Process

ANALYZE → DESIGN → IMPLEMENT → VALIDATE

Step 1: Analyze

Determine agent requirements:

• What specific domain or task?
• What tools needed?
• What model appropriate?
• Clear trigger conditions?

Step 2: Design

Agent Type

Type	Pattern	Example
Technical	[technology]-expert	react-expert, postgres-expert
Domain	[domain]-specialist	security-specialist, performance-specialist
Process	[process]-agent	code-review-agent, refactor-agent

Color by Domain

Domain	Color
Frontend	blue
Backend	green
Security	red
Performance	yellow
Testing	purple
DevOps	gray

Step 3: Implement

Create file .claude/agents/<name>.md following @.claude/skills/agent-creator/references/template.md exactly.

Important: Follow Format Rules from template.md for YAML fields.

Step 4: Validate

Check before saving:

• Name matches filename (kebab-case)
• Description explains when to use
• Tools minimal (only what needed)
• YAML format per template.md Format Rules
• Clear expertise boundaries
• Constraints defined

Decision Rules

Tool Restriction

Restrict tools when:

• Agent should only read, not modify
• Limited to specific commands (e.g., Bash(git:*))
• Security-sensitive domain

Grant all tools when:

• General-purpose agent
• Needs full file system access
• Complex multi-step workflows