| name | create-subagents |
| description | Expert guidance for creating, building, and using Claude Code subagents and the Task tool. Use when working with subagents, setting up agent configurations, understanding how agents work, or using the Task tool to launch specialized agents. |
Subagents are specialized Claude instances that run in isolated contexts with focused roles and limited tool access. This skill teaches you how to create effective subagents, write strong system prompts, configure tool access, and orchestrate multi-agent workflows using the Task tool.
Subagents enable delegation of complex tasks to specialized agents that operate autonomously without user interaction, returning their final output to the main conversation.
<quick_start>
- Run
/agents command
- Select "Create New Agent"
- Choose project-level (
.claude/agents/) or user-level (.claude/agents/)
- Define the subagent:
- name: lowercase-with-hyphens
- description: When should this subagent be used?
- tools: Optional comma-separated list (inherits all if omitted)
- model: Optional (
sonnet, opus, haiku, or inherit)
- Write the system prompt (the subagent's instructions)
```markdown
---
name: code-reviewer
description: Expert code reviewer. Use proactively after code changes to review for quality, security, and best practices.
tools: Read, Grep, Glob, Bash
model: sonnet
---
You are a senior code reviewer focused on quality, security, and best practices.
<focus_areas>
- Code quality and maintainability
- Security vulnerabilities
- Performance issues
- Best practices adherence
</focus_areas>
<output_format>
Provide specific, actionable feedback with file:line references.
</output_format>
Tailor instructions to the specific task domain. Don't create generic "helper" subagents.
Claude automatically selects subagents based on the `description` field when it matches the current task.
You can explicitly invoke a subagent:
Run `/agents` for an interactive interface to:
- View all available subagents
- Create new subagents
- Edit existing subagents
- Delete custom subagents
**Core references**:
