claude-code-subagents

# Claude Code Subagents

Guide Claude through creating and configuring specialized subagents for Claude Code.

## Purpose

Subagents are pre-configured AI personalities that handle specific types of tasks with their own context windows, custom system prompts, and tool configurations. This skill helps create well-structured subagents that improve task delegation, context management, and specialized workflows.

## When to Use This Skill

Use this skill when:

- Creating new custom subagents (project, personal, or plugin)
- Configuring subagent properties (tools, model, system prompts)
- Setting up specialized workflows with subagent delegation
- Troubleshooting subagent invocation or behavior

## Subagent Types

### Project Subagents

- Stored at: `.claude/agents/`
- Shared with the team (versioned in git)
- Highest priority when name conflicts occur
- Team-specific workflows and conventions

### Personal Subagents

- Stored at: `~/.claude/agents/`
- Available across all projects
- Lower priority than project subagents
- Personal preferences and workflows

### Plugin Subagents

- Stored at: `agents/` in plugin root
- Distributed via plugin marketplaces
- Shown as `(plugin:plugin-name)` in `/agents`
- Support all configuration features
- Can be invoked explicitly or automatically

## Creating Subagents

### Quick Creation with Helper Script

Use the bundled creation script for fast, templated subagent setup:

```bash
# Create project subagent with code-reviewer template
scripts/create_subagent.sh code-reviewer --project --template code-reviewer

# Create personal subagent with custom template
scripts/create_subagent.sh my-agent --user --template debugger

# Create plugin subagent (auto-detects plugin from current directory)
scripts/create_subagent.sh my-agent --plugin

# Create plugin subagent for specific plugin
scripts/create_subagent.sh my-agent --plugin my-plugin-name

# Available templates: code-reviewer, debugger, custom
```

The script is located at: `scripts/cr