Swarm Orchestration
FreeCoordinate multi-agent tasks across complex codebases.
Free · Opens the source repo
What Swarm Orchestration does
The Swarm Orchestration skill is designed for developers and teams managing complex software projects that require coordination among multiple agents. This skill utilizes a hierarchical topology to effectively break down and execute tasks that span across three or more files or modules. By leveraging specialized agents, it allows for efficient implementation of new features, refactoring, and other intricate changes that would otherwise be cumbersome to handle manually.
With the Swarm Orchestration skill, users can initialize a swarm of agents, route tasks to the appropriate agents based on their type, and monitor the status of the swarm in real-time. This is particularly useful when dealing with API changes that require testing, security updates, or performance optimizations across a codebase. The skill's ability to orchestrate tasks across multiple agents ensures that complex workflows are handled in a structured and efficient manner.
This skill is ideal for teams that frequently engage in collaborative coding efforts, particularly when changes are interdependent across various modules. It streamlines the process of managing complex tasks, reducing the overhead of coordination and increasing overall productivity. The included scripts for starting and monitoring the swarm provide additional utility, allowing users to quickly set up their environment and keep track of ongoing tasks.
However, this skill is not suitable for simpler tasks such as single file edits or minor bug fixes. It is specifically tailored for scenarios where the complexity of the work justifies the overhead of managing a swarm of agents. For straightforward changes or documentation updates, users may find it more efficient to use traditional methods without the orchestration framework.
When to use it
Use this skill when working on projects that involve multiple files requiring changes, such as new feature implementations or significant refactoring.
When not to use it
Avoid using this skill for simple edits, minor bug fixes, or documentation updates where orchestration is unnecessary.
What you can build with it
Implementing OAuth2 Authentication
When tasked with implementing an OAuth2 authentication flow, you can route this complex task to specialized agents to ensure efficient execution.
Refactoring an Authentication Module
For a project requiring a refactor of the authentication module, orchestrate the task across multiple agents to handle the changes systematically.
Performing Database Schema Changes
When needing to update the database schema alongside code changes, use this skill to manage the interdependencies effectively.
How to install Swarm Orchestration
View source1. Install with the skills CLI
npx skills add ruvnet/ruflo/swarm-orchestration --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by ruvnetSwarm Orchestration Skill
Purpose
Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules.
When to Trigger
- 3+ files need changes
- new feature implementation
- cross-module refactoring
- API changes with tests
- security-related changes
- performance optimization across codebase
- database schema changes
When to Skip
- single file edits
- simple bug fixes (1-2 lines)
- documentation updates
- configuration changes
- quick exploration
Commands
Initialize Swarm
Start a new swarm with hierarchical topology (anti-drift)
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 8 --strategy specialized
Example:
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 6 --strategy specialized
Route Task
Route a task to the appropriate agents based on task type
npx @claude-flow/cli hooks route --task "[task description]"
Example:
npx @claude-flow/cli hooks route --task "implement OAuth2 authentication flow"
Spawn Agent
Spawn a specific agent type
npx @claude-flow/cli agent spawn --type [type] --name [name]
Example:
npx @claude-flow/cli agent spawn --type coder --name impl-auth
Monitor Status
Check the current swarm status
npx @claude-flow/cli swarm status --verbose
Orchestrate Task
Orchestrate a task across multiple agents
npx @claude-flow/cli task orchestrate --task "[task]" --strategy adaptive
Example:
npx @claude-flow/cli task orchestrate --task "refactor auth module" --strategy parallel --max-agents 4
List Agents
List all active agents
npx @claude-flow/cli agent list --filter active
Scripts
| Script | Path | Description |
|---|---|---|
swarm-start | .agents/scripts/swarm-start.sh | Initialize swarm with default settings |
swarm-monitor | .agents/scripts/swarm-monitor.sh | Real-time swarm monitoring dashboard |
References
| Document | Path | Description |
|---|---|---|
Agent Types | docs/agents.md | Complete list of agent types and capabilities |
Topology Guide | docs/topology.md | Swarm topology configuration guide |
Best Practices
- Check memory for existing patterns before starting
- Use hierarchical topology for coordination
- Store successful patterns after completion
- Document any new learnings
Frequently asked questions about Swarm Orchestration
Similar skills
React Composition Patterns
Streamline your React component architecture with proven patterns.
Pester Should Migration
Easily convert Pester v5 assertions to v6 syntax.
Radix to Base UI Migration
Seamlessly migrate React components from Radix UI to Base UI.
Migrate Next.js to Vinext
Seamlessly transition your Next.js projects to Vinext.
WinUI 3 Migration Guide
Streamline your UWP to WinUI 3 migration process.
Refactor
Enhance code maintainability without altering behavior.