Create Agent Command

Create autonomous Claude Code agents that handle complex, multi-step tasks independently. This command provides comprehensive guidance based on official Anthropic documentation and proven patterns.

User Input

Agent Name: $1
Description: $2

What Are Agents?

Agents are autonomous subprocesses spawned via the Task tool that:

• Handle complex, multi-step tasks independently
• Have their own isolated context window
• Return results to the parent conversation
• Can be specialized for specific domains

Concept	Agent	Command
Trigger	Claude decides based on description	User invokes with /name
Purpose	Autonomous work	User-initiated actions
Context	Isolated subprocess	Shared conversation
File format	agents/*.md	commands/*.md

Agent File Structure

Agents use a unique format combining YAML frontmatter with a markdown system prompt:

---
name: agent-identifier
description: Use this agent when [triggering conditions]. Examples:

<example>
Context: [Situation description]
user: "[User request]"
assistant: "[How assistant should respond and use this agent]"
<commentary>
[Why this agent should be triggered]
</commentary>
</example>

<example>
[Additional example...]
</example>

model: inherit
color: blue
tools: ["Read", "Write", "Grep"]
---

You are [agent role description]...

**Your Core Responsibilities:**
1. [Responsibility 1]
2. [Responsibility 2]

**Analysis Process:**
[Step-by-step workflow]

**Output Format:**
[What to return]

Frontmatter Fields Reference

Required Fields

name (Required)

Format: Lowercase with hyphens only Length: 3-50 characters Rules:

• Must start and end with alphanumeric character
• Only lowercase letters, numbers, and hyphens
• No underscores, spaces, or special characters