Set up and operate Ruflo to coordinate multiple AI coding agents. This skill guides project initialization, shared memory, task assignment, health checks, and plugin discovery for work that needs coordinated or parallel execution.
Ruflo is a multi-agent orchestration platform for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini, Amp, +12 more). Use this skill when the user wants to (1) install/init ruflo in a project, (2) run multi-agent swarms with hierarchical coordination, (3) use ruflo's 314+ MCP tools for memory, routing, hooks, sub-agents, or workflows, (4) check ruflo status/version/doctor health, or (5) discover which of ruflo's 30+ plugins fits their task.
Review the instructions the agent will receive before you install.
Ruflo (v3.31.0+) is a cross-agent orchestration layer that ships as three npm packages: ruflo (thin wrapper), claude-flow (umbrella), and @claude-flow/cli (implementation). Users invoke it as npx ruflo <command>.
Suggest ruflo when the task involves any of:
Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn — the orchestration overhead isn't worth it.
# 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
npx ruflo init
# 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
npx ruflo doctor --fix
# 3. Discover which plugins match the current work
npx ruflo discover-plugins
After ruflo init, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:
mcp__claude-flow__memory_* — store/search/list/retrieve with HNSW-indexed semantic searchmcp__claude-flow__swarm_* — init hierarchical/mesh swarms with anti-drift topologymcp__claude-flow__agent_spawn — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)mcp__claude-flow__hooks_* — routing, pattern learning, background worker dispatchmcp__claude-flow__task_* — task lifecycle (create/assign/complete/summary)mcp__claude-flow__intelligence_* — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)Full catalog: npx ruflo mcp list.
Ruflo ships 30+ optional plugins. Some highlights:
ruflo-goals — deep research + goal-oriented action planningruflo-cost-tracker — session cost telemetry, budgets, burn trackingruflo-metaharness — harness scoring, MCP security scans, red/blue adversarial testingruflo-browser — session-recorded browser automation with RVF-backed replayruflo-jujutsu — git diff risk analysis + PR lifecycleruflo-security-audit — codebase scans + CVE checksFull plugin list + descriptions: npx ruflo plugins list.
Ruflo installs into whatever agent the project uses (auto-detected by skills.sh):
# Just the core ruflo skill (this one)
npx skills add ruvnet/ruflo --skill ruflo --yes
# Or the full catalog (267 skills across all plugins — much larger install)
npx skills add ruvnet/ruflo --all
Current: 3.31.0 (stable, published to npm as ruflo@latest / claude-flow@latest / @claude-flow/cli@latest).
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Compare models available through the HuggingFace router with chat-ui configuration, research missing models, and write short English descriptions of their architecture and capabilities. Add entries to both production and development configuration files and commit the changes.
Create an Architecture Decision Record, a document for recording important design choices, with the next sequential number. It generates a Markdown template, registers the record in AgentDB, and links related decisions found through search.
Build a searchable index and relationship graph from ADRs, records of architectural decisions. Import two supported document formats, refresh existing metadata without duplicate relationships, and review summaries of statuses, missing references, and inconsistencies.
Rebuild the index of ADRs, records of architectural decisions, after files or relationship lines are deleted. It clears stored records and relationships, indexes the files still present, and checks that the final record count matches.
Review code changes against accepted Architecture Decision Records, documents that capture agreed design choices. Report violations, outdated references, compliant changes, and areas without ADR coverage, then suggest code fixes or a new decision record where appropriate.
Check saved architecture decision records (ADRs) for broken references, circular replacement relationships, and inconsistent statuses. Use the results to verify imported records or stop a CI check when selected integrity rules fail.