# Orchestrating Swarms > Facade skill for multi-agent swarm orchestration in Claude Code — routes to specialist skills covering primitives, spawning, operations, and patterns. Use when coordinating multiple agents in parallel, building pipeline workflows with dependencies, running parallel code reviews, creating self-organizing task queues, designing divide-and-conquer workloads, or choosing between TeamCreate and Agent tool approaches. Loads swarm-primitives (team lifecycle and message flow), swarm-spawning (agent types and backends), swarm-operations (tool API and error handling), and swarm-patterns (six orchestration recipes with complete workflows). Use when this capability is needed. - Skill: `tomevault-io/orchestrating-swarms-3` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/orchestrating-swarms-3` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/orchestrating-swarms-3/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/orchestrating-swarms-3 --- # Claude Code Swarm Orchestration Master multi-agent orchestration using Claude Code's TeamCreate, SendMessage, TeamDelete, and Agent tools. This skill is a facade that routes to 4 specialist skills. Load whichever you need. --- ## Specialist Skills ### Core Concepts `Skill(skill: "swarm-primitives")` What teams, teammates, tasks, and inboxes are. File layouts, team config structure, lifecycle diagrams, message flow sequences. ### Spawning Agents `Skill(skill: "swarm-spawning")` How to create agents -- subagent vs teammate decision, built-in agent types (Explore, Plan, general-purpose, Bash, etc.), plugin agent types, spawn backends (in-process, tmux, iterm2), environment variables. ### API Reference `Skill(skill: "swarm-operations")` Tool signatures and message schemas -- TeamCreate, SendMessage (direct, broadcast, shutdown, plan approval), TeamDelete, Agent tool parameters. Error handling, graceful shutdown sequence, crashed teammate recovery, debugging. ### Patterns and Recipes `Skill(skill: "swarm-patterns")` 6 orchestration patterns (parallel specialists, pipeline, swarm, research+implement, plan approval, coordinated refactoring), 3 complete workflows, best practices, quick reference. ### Checklist-to-Swarm Automation `Skill(skill: "swarm-from-markdown")` Parse a markdown `- [ ]` checklist file and generate the full `TeamCreate` + `TaskCreate` + `Agent` call sequence automatically. Use when you have a `todo.md` or any checkbox file and want to dispatch items as a self-organizing swarm without writing the TaskCreate loop by hand. --- ## Quick Start ```mermaid flowchart TD Start([What do you need?]) --> Q1{Your goal?} Q1 -->|Understand how swarms work| P[swarm-primitives] Q1 -->|Choose agent types or backends| S[swarm-spawning] Q1 -->|Look up tool API or message format| O[swarm-operations] Q1 -->|Build a workflow from a recipe| R[swarm-patterns] Q1 -->|Dispatch a markdown checklist as a swarm| M[swarm-from-markdown] Q1 -->|Full reference on everything| All[Load all 5 skills] ``` --- ## Minimal Example ```javascript // 1. Create team TeamCreate({ team_name: "my-team" }) // 2. Create tasks TaskCreate({ subject: "Review auth", description: "Review auth module", activeForm: "Reviewing..." }) TaskCreate({ subject: "Review API", description: "Review API endpoints", activeForm: "Reviewing..." }) // 3. Spawn teammates Agent({ team_name: "my-team", name: "reviewer-1", subagent_type: "general-purpose", prompt: "Claim task #1, review it, send findings to team-lead.", run_in_background: true }) Agent({ team_name: "my-team", name: "reviewer-2", subagent_type: "general-purpose", prompt: "Claim task #2, review it, send findings to team-lead.", run_in_background: true }) // 4. Collect results (messages arrive automatically) // 5. Shutdown and cleanup SendMessage({ type: "shutdown_request", recipient: "reviewer-1", content: "Done" }) SendMessage({ type: "shutdown_request", recipient: "reviewer-2", content: "Done" }) // Wait for approvals... TeamDelete() ``` --- SOURCE: Claude Code v2.1.45 -- verified 2026-02-18 --- > Source: [jamie-bitflight/claude_skills](https://github.com/jamie-bitflight/claude_skills) — distributed by [TomeVault](https://tomevault.io).