name: new-agent
description: Create custom Claude Code subagents. Interactive wizard that gathers requirements, generates the agent .md file with proper frontmatter and system prompt. Use when creating a new agent, adding a subagent, or making a custom agent available globally. Keywords: agent, subagent, create agent, new agent, custom agent
disable-model-invocation: true
argument-hint: "[agent-description or leave blank for interactive]"
New Agent Creator
Creates custom Claude Code subagents as .md files with YAML frontmatter and a system prompt.
Agent Storage Locations
| Location | Scope | When to use |
|---|
.claude/agents/ | Current project | Team-shared, checked into version control |
~/.claude/agents/ | All projects | Personal agents across your machine |
Before creating an agent, list existing agents in the target directory to avoid name conflicts.
Agent File Format
---
name: agent-name
description: When Claude should use this agent. Include 2-3 <example> blocks.
color: green
model: inherit
memory: user
---
System prompt content here — this becomes the agent's entire personality and instructions.
Frontmatter Fields
| Field | Required | Default | Description |
|---|
name | Yes | — | Lowercase, hyphens only. Must be unique across all agents. |
description | Yes | — | Critical for delegation. Must include <example> blocks. |
tools | No | All tools | Comma-separated allowlist: Read, Grep, Glob, Bash, Write, Edit etc. |
disallowedTools | No | — | Tools to explicitly deny (removed from inherited set). |
