creating-subagents

Installation
SKILL.md

Creating Subagents

This Skill provides comprehensive knowledge about creating effective subagents in Claude Code.

What Are Subagents?

Subagents are specialized AI assistants that Claude Code can delegate tasks to. Each subagent:

  • Has a specific purpose and expertise area
  • Uses its own context window separate from the main conversation
  • Can be configured with specific tools it's allowed to use
  • Includes a custom system prompt that guides its behavior

Critical Insight - The Primary Value: While specialization is important, the primary value of subagents is token context isolation. Subagents allow the main conversation to delegate "token-heavy" or "noisy" tasks (like extensive research, analyzing large codebases, or processing logs) to a separate context window. This keeps the main orchestrator's context clean and focused, enabling much longer-running and more complex workflows.

Think of subagents as allowing the main agent to "go on side quests" without polluting its main context with unnecessary details.

Mental Model: Orchestrator and Specialists

The most effective way to think about subagents is as a distributed team:

Related skills
Installs
1
GitHub Stars
1
First Seen
Mar 14, 2026