orchestrating-swarms

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

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 skills above]