---

name: add-agent description: Add a new subagent to an existing Claude Code plugin. Use when user wants to create an agent. user-invocable: true

Add Agent

You are adding a new subagent to a Claude Code plugin. Agents are specialized Claude personas that can be spawned via the Task tool. Follow these steps:

1. Gather Information

Ask the user for:

• Plugin path (which plugin to add to, or current directory)
• Agent name (kebab-case, e.g., code-reviewer)
• Description (what does this agent specialize in?)
• Capabilities (what can it do?)
• When to use (when should Claude spawn this agent?)

2. Create Agent File

Copy<plugin>/agents/<agent-name>.md

Note: Agents are .md files directly in the agents/ folder (not subdirectories like skills).

3. Generate Agent Markdown

Use this format:

Copy---
description: <brief description of agent's specialty>
capabilities: [<capability1>, <capability2>, ...]
---

# <Agent Name>

<Overview of what this agent does>

## When to Invoke

Use this agent when:
- <Trigger condition 1>
- <Trigger condition 2>

## Capabilities

- <Detailed capability 1>
- <Detailed capability 2>

## Process

1. <How the agent approaches tasks>
2. <Steps it follows>

## Guidelines

- <Behavioral guideline 1>
- <Behavioral guideline 2>

4. Frontmatter Reference

Available frontmatter fields:

• description (required): Brief description for agent selection
• capabilities: Array of capability tags

5. Best Practices

• Focused specialty: Each agent should have a clear domain
• Clear triggers: Specify exactly when to spawn this agent
• Autonomous operation: Agents run independently, design accordingly
• Return useful results: Agent output goes back to main Claude