skill CX Codex

ruflo-doctor — Claude Code skill: what it does, how to install

Q: How do I install ruflo-doctor in Claude Code?

Run `npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code`. The skill file lands at `~/.claude/skills/ruflo-doctor/SKILL.md`.

Q: What does ruflo-doctor do?

It calls `npx @claude-flow/cli@latest doctor --fix` to check the environment, config, daemon, memory database and MCP servers, then repair common failures.

Runs a health check on a Ruflo install: Node.js, npm, git, config, daemon, memory database, API keys, MCP servers. Add --fix and it repairs the usual breakages.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code

Open on GitHub

What ruflo-doctor does

One command does the work: npx @claude-flow/cli@latest doctor --fix. The skill is allowed to run only Bash(npx *), so whatever the CLI cannot repair stays broken — no manual file surgery from the agent.

The report covers Node.js and npm versions, git, config validity, daemon status, the memory database, API keys, MCP servers, disk space and TypeScript. Some failures have their own command: memory init --force rebuilds the memory database, daemon start brings the daemon up, config reset puts the config back to a clean baseline.

The checks earn their keep once Ruflo is installed and misbehaving. Note that they expect Node.js 20+ and npm 9+, so an older setup will fail at the top of the report. And keep a copy of your config before running --fix: config reset will not preserve hand edits.

What it helps with

diagnose a broken Ruflo install with one command
rebuild the memory database after it stops opening
bring a dead daemon back up
restore a working config after bad manual edits
confirm Node.js 20+, npm 9+ and git before the first run

Example prompts for the agent

Run ruflo-doctor and tell me what is broken
Run the Ruflo check with --fix and repair what you can
Use the ruflo-doctor skill on this install, then restart the daemon

How to install ruflo-doctor

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code

2Manually: put the files in place

~/.claude/skills/ruflo-doctor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ruflo-doctor/

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill ruflo-doctor -a codex

2Manually: put the files in place

.agents/skills/ruflo-doctor/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill ruflo-doctor -a cursor

2Manually: put the files in place

.cursor/skills/ruflo-doctor/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install ruvnet/ruflo ruflo-doctor

2Manually: put the files in place

.github/skills/ruflo-doctor/SKILL.md

1Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill ruflo-doctor -a gemini-cli

2Platform CLI

gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-core/skills/ruflo-doctor

Manually: put the files in place

.devin/skills/ruflo-doctor/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill ruflo-doctor -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ruflo-doctor

How do I install ruflo-doctor in Claude Code?

Run npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code. The skill file lands at ~/.claude/skills/ruflo-doctor/SKILL.md.

What does ruflo-doctor do?

It calls npx @claude-flow/cli@latest doctor --fix to check the environment, config, daemon, memory database and MCP servers, then repair common failures.

What does it need to run?

Node.js 20+ and npm 9+. Below that the report opens with environment errors, and the remaining checks may not get a fair run.

Source text

SKILL.md · MIT

---
name: ruflo-doctor
description: Run health checks on the Ruflo installation and fix common issues
argument-hint: "[--fix]"
allowed-tools: Bash(npx *)
---
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`

ctx-doctor mksglu Runs context-mode health checks directly inside your agent session. It inspects runtimes, hooks, FTS5, and package versions to troubleshoot setup issues. CX Codex +1 1,600installs omc-doctor Yeachan-Heo A skill that audits an oh-my-claudecode install: compares the plugin version against npm and hunts stale hooks in your settings files. Useful when the plugin looks installed but nothing changes. CX Codex +1 838installs insforge-cli InsForge Manages InsForge backend and cloud infrastructure through the CLI. Useful for setting up projects, SQL migrations, RLS policies, and secrets before writing app code. CX Codex +1 60,500installs compose-doctor goldsky-io A skill that diagnoses broken Goldsky Compose apps: failing tasks, crashloops, missed events, bundler and wallet errors. Useful once an app is deployed and something stops working. CX Codex +1 3,500installs cargo-diagnostics getcargo A skill that explains what a Cargo run or batch actually did: walks it node by node, draws the executed graph with the failing step marked, groups errors by root cause and attributes credit spend. CX Codex +1 8,700installs openagent 5dive-ai The skill walks you through OpenAgent: write <id>.persona.yaml, validate the schema, check rarity, render a PNG card. CX Codex +1 1,300installs

From the same set146

iot-fleet Manages Cognitum Seed device fleets through the cognitum-iot command line tool. It creates groups, lists fleets, and modifies device membership. CX Codex +1 764installs pii-detect Scans text, source code, and configs for personal data, tokens, and credentials before commits or logging. Flags exposed lines and suggests redaction. CX Codex +1 762installs discover-plugins A skill that discovers and recommends ruflo plugins based on your workflow, installed MCP tools, and current task. Handy when starting a new project or figuring out which plugins fit your needs. CX Codex +1 757installs cognitive-pattern Defines reasoning patterns for agents and turns them into executable workflows. Use it for decision trees, task decomposition, analogy-based reasoning, or multi-perspective choices. CX Codex +1 756installs test-gaps Detects missing test coverage and suggests tests to write. Helpful right after adding a new feature or before cutting a release. CX Codex +1 753installs autopilot-loop A skill that runs one iteration of an autonomous loop: checks progress, picks the next task, schedules the next wake. Use it when you want Claude to keep working without manual breaks between tasks. CX Codex +1 752installs diff-analyze Analyzes a git diff before a PR, scoring risk, classifying changes, and suggesting reviewer roles. Use it before merging a large change. CX Codex +1 751installs research-synthesize Turns findings stored in ruflo memory into one report, with evidence grades, contradiction handling and next steps. Useful after a run of deep-research. CX Codex +1 751installs