plugins/claude-workflow/skills/orchestration/SKILL.md
Multi-agent orchestration patterns for Claude Code team mode. Use when coordinating teammates, decomposing complex tasks, or managing shared task lists.
npx skillsauth add spences10/claude-code-toolkit orchestrationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Patterns for coordinating multi-agent work in Claude Code using team mode.
Source: code.claude.com/docs/en/agent-teams
Tell the lead what team you want in natural language:
Create an agent team to refactor the auth module. Spawn three teammates:
- One focused on extracting shared utilities
- One migrating tests to the new structure
- One updating documentation
Use Sonnet for each teammate.
The lead creates the team, spawns teammates, distributes work via a shared task list, and synthesizes results.
| Component | Role |
| ------------- | --------------------------------------------------------------- |
| Team lead | Your main session — creates team, spawns teammates, coordinates |
| Teammates | Separate Claude Code instances working on assigned tasks |
| Task list | Shared work items teammates claim and complete |
| Messaging | SendMessage for DMs, broadcasts, and shutdown requests |
Teammates are persistent — they go idle between turns and can be woken up with messages. They can message each other directly.
| | Subagents | Teams | | ----------------- | ---------------------------------- | ------------------------------------------ | | Communication | Report back to caller only | Message each other directly | | Coordination | Main agent manages all work | Shared task list, self-coordination | | Best for | Focused tasks, only result matters | Complex work needing collaboration | | Token cost | Lower | Higher (each teammate = separate instance) |
development
Design and create Claude Skills using progressive disclosure principles. Use when building new skills, planning skill architecture, or writing skill content.
testing
Verify sources before presenting findings. Use when asked to research links or documentation.
data-ai
Analyze session history for learnings and persist to skills. Solves "memory zero" - correct once, never again.
tools
Validate, test, and distribute Claude Code plugins and marketplaces. Use when developing plugins, debugging validation errors, or preparing for distribution.