How do I install the Orchestrating Swarms skill?

Run npx skillmds@latest add tomevault-io/orchestrating-swarms-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Orchestrating Swarms safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Orchestrating Swarms?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Orchestrating Swarms free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Orchestrating Swarms?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Orchestrating Swarms by tomevault-io

Name: Orchestrating Swarms
Author: tomevault-io

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.

tomevault-io Updated Sep 17, 2026

File contents

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

Minimal Example

// 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 — distributed by TomeVault.

---name: orchestrating-swarms-3description: 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.---# Claude Code Swarm OrchestrationMaster 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```mermaidflowchart 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 teamTeamCreate({ team_name: "my-team" })// 2. Create tasksTaskCreate({ subject: "Review auth", description: "Review auth module", activeForm: "Reviewing..." })TaskCreate({ subject: "Review API", description: "Review API endpoints", activeForm: "Reviewing..." })// 3. Spawn teammatesAgent({ 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 cleanupSendMessage({ 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).

Frequently asked questions