Ruflo Doctor
- 664 installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
ruflo-doctor is a Ruflo agent skill that runs npx @claude-flow/cli doctor --fix to diagnose and auto-repair common issues in Ruflo installations, MCP servers, and agent workflow dependencies.
About
ruflo-doctor is a Ruflo health-check skill that executes npx @claude-flow/cli@latest doctor --fix to scan and repair a Claude-Flow/Ruflo stack. The doctor command validates Node.js 20+, npm 9+, git, config validity, daemon status, memory database, API keys, MCP servers, disk space, and TypeScript setup, then applies targeted fixes such as memory init --force, daemon start, and config reset. Developers reach for ruflo-doctor when agent workflows stall, MCP connections fail, daemons are down, or Ruflo config drift breaks local runs. The skill accepts an optional --fix flag via argument-hint and restricts tooling to Bash(npx *) for safe CLI invocation. Outputs are a pass/fail diagnostic report plus applied repair actions agents can rerun until the stack is green.
- Scans agent configurations, tool calls, and execution traces for common failure patterns
- Generates concise diagnostic reports with severity levels and recommended fixes
- Supports both local and remote agent health checks
- Integrates directly with Claude Code, Cursor, and custom agent loops
- Hard-gate: run before committing changes to any agent skill or workflow
Ruflo Doctor by the numbers
- 664 all-time installs (skills.sh)
- +7 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #1,474 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill ruflo-doctorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 664 |
|---|---|
| repo stars | ★ 67k |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do you diagnose and fix Ruflo agent issues?
Automatically diagnose, debug, and repair issues in their AI agent workflows and MCP servers.
Who is it for?
Developers running Ruflo or Claude-Flow agent stacks who hit MCP, daemon, config, or dependency failures and need automated repair.
Skip if: Skip ruflo-doctor when debugging unrelated application code bugs outside the Ruflo CLI, daemon, or MCP installation layer.
When should I use this skill?
Trigger when Ruflo, Claude-Flow, or MCP server health fails, or when phrases like ruflo doctor, agent workflow broken, or daemon not running appear.
What you get
Health-check report, repaired Ruflo config, restarted daemon, and reinitialized memory database.
- diagnostic report
- repaired configuration
- running daemon
By the numbers
- Runs 11 environment and MCP health checks
- Documents 3 targeted auto-repair commands: memory init, daemon start, config reset
Files
Run npx @claude-flow/cli@latest doctor --fix to diagnose and auto-repair common issues.
Checks: Node.js 20+, npm 9+, git, config validity, daemon status, memory database, API keys, MCP servers, disk space, TypeScript.
Targeted fixes:
- Memory:
npx @claude-flow/cli@latest memory init --force - Daemon:
npx @claude-flow/cli@latest daemon start - Config:
npx @claude-flow/cli@latest config reset
Related skills
Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k
Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k
CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k
Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k
Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72
Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10How it compares
Use ruflo-doctor for Ruflo stack health; use application-level debugging skills when failures originate in your app source code rather than agent infrastructure.
FAQ
What does ruflo-doctor check?
ruflo-doctor runs npx @claude-flow/cli doctor checks for Node.js 20+, npm 9+, git, config validity, daemon status, memory database, API keys, MCP servers, disk space, and TypeScript before optional --fix repairs.
What fixes can ruflo-doctor apply automatically?
ruflo-doctor can run memory init --force, daemon start, and config reset via npx @claude-flow/cli@latest when --fix is passed, targeting the most common Ruflo installation failures.
Which CLI command does ruflo-doctor execute?
ruflo-doctor executes npx @claude-flow/cli@latest doctor --fix, using argument-hint [--fix] and allowed-tools Bash(npx *) so agents invoke the official Claude-Flow doctor entrypoint.