Agent skill

Swarm Orchestration

by ruvnet in ruvnet/ruflo

Multi-agent swarm coordination for complex tasks. An agent skill from ruvnet/ruflo.

MITAuto-check passedDevelopment

Install Swarm Orchestration

skills CLI
$ npx skills add ruvnet/ruflo --skill swarm-orchestration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/ruflo swarm-orchestration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/v3/@claude-flow/codex/.agents/skills/swarm-orchestration .claude/skills/swarm-orchestration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
swarm-orchestration
GitHub stars
74k
Token cost
~261 tokens
SKILL.md length
82 words
Files
1
Skills in repo
265
Repo updated
First seen
Licence
MIT

At a glance

Multi-agent swarm coordination for complex tasks. An agent skill from ruvnet/ruflo.

  • Works in 4 steps: Check memory for existing patterns… → Use hierarchical topology for coordination → Store successful patterns after completion → …
  • : 3+ files need changes
  • SKILL.md covers Purpose, When to Trigger, When to Skip and Commands, plus 1 more section
  • Calls npx

What it does

Swarm Orchestration is an agent skill from ruvnet/ruflo. Multi-agent swarm coordination for complex tasks. Use when: 3+ files need changes, new features, refactoring. Skip when: single file edits, simple fixes, documentation.

Its SKILL.md is about 260 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Multi-agent orchestration and Refactoring. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • : 3+ files need changes
  • Tasks that involve Multi-agent orchestration
  • Tasks that involve Refactoring

Example prompts

  • “/swarm-orchestration”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check memory for existing patterns before starting
  2. Use hierarchical topology for coordination
  3. Store successful patterns after completion
  4. Document any new learnings

What it can do on your machine

Read from SKILL.md and the folder at commit 6c04654. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Swarm Orchestration loads about 261 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 82 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~261

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 6c04654, republished under its MIT licence (© ruvnet). 82 words, ~261 tokens.

Download SKILL.mdSave it as .claude/skills/swarm-orchestration/SKILL.md (or your agent's skills folder).
name
swarm-orchestration
description
Multi-agent swarm coordination for complex tasks. Use when: 3+ files need changes, new features, refactoring. Skip when: single file edits, simple fixes, documentation.

Swarm Orchestration Skill

Purpose

Multi-agent swarm coordination for complex tasks.

When to Trigger

  • 3+ files need changes
  • new features
  • refactoring

When to Skip

  • single file edits
  • simple fixes
  • documentation

Commands

Initialize Swarm

Start a new swarm with hierarchical topology

bash
npx @claude-flow/cli swarm init --topology hierarchical --max-agents 8
Route Task

Route a task to the appropriate agents

bash
npx @claude-flow/cli hooks route --task "[task description]"
Monitor Status

Check the current swarm status

bash
npx @claude-flow/cli swarm status

Best Practices

  1. Check memory for existing patterns before starting
  2. Use hierarchical topology for coordination
  3. Store successful patterns after completion
  4. Document any new learnings

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in v3/@claude-flow/codex/.agents/skills/swarm-orchestration of ruvnet/ruflo.

Open the folder on GitHubat commit 6c04654

Compare with similar skills

Swarm Orchestration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Swarm Orchestration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swarm Orchestration this skillruvnet/ruflo74k—~261Automated safety check: PassMIT
Optimize Protocol0x0funky/vibehq-hub195—~3.2kAutomated safety check: PassMIT
Stream Chainruvnet/agentic-flow8185 repos~3.2kAutomated safety check: PassNone
Orchestrationnumman-ali/n-skills1.1k—~7.7kAutomated safety check: PassApache-2.0
Agent Workflow Designeralirezarezvani/claude-skills28k—~681Automated safety check: PassMIT
Flow SwarmLeoYeAI/openclaw-master-skills2.2k—~5.3kAutomated safety check: PassMIT

Similar skills

  • Optimize Protocol

    0x0funky/vibehq-hub

    Autonomous framework engineer — reads VibeHQ post-run analysis, understands root causes of multi-agent coordination failures, then designs and implements real code changes (new features, refactors…

    195 GitHub stars~3.2k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Stream Chain

    ruvnet/agentic-flow

    Stream-JSON chaining for multi-agent pipelines, data transformation, and sequential workflows

    818 GitHub starsUsed in 5 repos~3.2k tokens
    DevelopmentAuto-check passed
  • Orchestration

    numman-ali/n-skills

    Multi-agent orchestration for complex tasks. An agent skill from numman-ali/n-skills.

    1.1k GitHub stars~7.7k tokensUpdated 28 days ago
    Agent WorkflowsAuto-check passed
  • Agent Workflow Designer

    alirezarezvani/claude-skills

    Design production-grade multi-agent workflows with clear pattern choice (sequential, parallel, hierarchical), handoff contracts, failure handling, and cost/context controls.

    28k GitHub stars~681 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Flow Swarm

    LeoYeAI/openclaw-master-skills

    Multi-agent swarm orchestration via RuFlo + Claude Code. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.3k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed

More from ruvnet/ruflo

All 265 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Questions about Swarm Orchestration

What does Swarm Orchestration do?

Multi-agent swarm coordination for complex tasks. An agent skill from ruvnet/ruflo. Swarm Orchestration is an agent skill from ruvnet/ruflo. Multi-agent swarm coordination for complex tasks.

When should I use Swarm Orchestration?

Swarm Orchestration fits situations like: : 3+ files need changes; tasks that involve Multi-agent orchestration; tasks that involve Refactoring.

How do I install Swarm Orchestration in Claude Code?

Run `npx skills add ruvnet/ruflo --skill swarm-orchestration -a claude-code`. Or copy the skill folder (v3/@claude-flow/codex/.agents/skills/swarm-orchestration in ruvnet/ruflo) into .claude/skills/swarm-orchestration in your project. Claude Code loads it when a task matches its description.

How do I install Swarm Orchestration in Codex?

Run `npx skills add ruvnet/ruflo --skill swarm-orchestration -a codex`. Or copy the skill folder (v3/@claude-flow/codex/.agents/skills/swarm-orchestration in ruvnet/ruflo) into .agents/skills/swarm-orchestration in your project. Codex loads it when a task matches its description.

Can I use Swarm Orchestration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill swarm-orchestration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swarm-orchestration, .gemini/skills/swarm-orchestration, .github/skills/swarm-orchestration and .opencode/skills/swarm-orchestration in your project.

What does Swarm Orchestration need to run?

Going by SKILL.md and its folder, Swarm Orchestration needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Swarm Orchestration access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Swarm Orchestration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Swarm Orchestration use?

Swarm Orchestration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Swarm Orchestration use?

About 261 tokens (SKILL.md is roughly 1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Swarm Orchestration?

Skills that share tags, products or a category with Swarm Orchestration: Optimize Protocol (0x0funky/vibehq-hub, 195 stars), Stream Chain (ruvnet/agentic-flow, 818 stars), Orchestration (numman-ali/n-skills, 1.1k stars) and Agent Workflow Designer (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swarm Orchestration?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,222 GitHub stars. The repository holds 265 skills in this directory. The repository was last updated on October 10, 2026.

Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.