subagent-creator

# Sub-agent Creator

Create specialized AI sub-agents for Claude Code that handle specific tasks
with customized prompts and tool access.

## Sub-agent File Format

Sub-agents are Markdown files with YAML frontmatter stored in:

- **Project**: `.claude/agents/` (higher priority)
- **User**: `~/.claude/agents/` (lower priority)

### Structure

```markdown
---
name: subagent-name
description: When to use (include "use proactively" for auto-delegation)
tools: Tool1, Tool2, Tool3  # Optional - inherits all if omitted
model: sonnet               # Optional - sonnet/opus/haiku/inherit
permissionMode: default     # Optional - default/acceptEdits/plan
skills: skill1, skill2      # Optional - auto-load skills
---

System prompt goes here. Define role, responsibilities, and behavior.
```

### Configuration Fields

| Field            | Required | Description                            |
| ---------------- | -------- | -------------------------------------- |
| `name`           | Yes      | Lowercase with hyphens                 |
| `description`    | Yes      | Purpose and when to use (key trigger)  |
| `tools`          | No       | Comma-separated tool list              |
| `model`          | No       | `sonnet`, `opus`, `haiku`, or `inherit`|
| `permissionMode` | No       | `default`, `acceptEdits`, `plan`, etc. |
| `skills`         | No       | Skills to auto-load                    |
| `hooks`          | No       | Hooks for lifecycle (PreToolUse, etc.) |

## Creation Workflow

1. **Gather requirements**: Ask about purpose, when to use, and capabilities
2. **Choose scope**: Project (`.claude/agents/`) or user (`~/.claude/agents/`)
3. **Define configuration**: Name, description, tools, model
4. **Write system prompt**: Clear role, responsibilities, and output format
5. **Create file**: Write the `.md` file to the appropriate location

## Writing Effective Sub-agents

### Description Best Practices

The `description` field is critical for automatic delegation:

```yaml
# Goo