ruflo-doctor — скилл для Claude Code: что делает и как установить
Скилл прогоняет диагностику установки Ruflo и показывает, что сломано: Node.js, npm, git, конфиг, демон, база памяти, ключи API, MCP-серверы. С флагом --fix чинит типовые поломки.
npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-codeЧто делает ruflo-doctor
Скилл вызывает одну команду: npx @claude-flow/cli@latest doctor --fix. Агент запускает её сам, других инструментов ему не выдано — в описании разрешён только Bash(npx *). Поэтому чинится ровно то, что умеет CLI, без правок руками.
В отчёт попадают версии Node.js и npm, git, валидность конфига, статус демона, база памяти, ключи API, MCP-серверы, место на диске и TypeScript. Для части проблем есть точечные команды: memory init --force пересобирает базу памяти, daemon start поднимает демон, config reset возвращает конфиг к базовому виду.
Польза появляется, когда Ruflo уже стоит и ведёт себя странно. Учтите: часть проверок рассчитана на Node.js 20+ и npm 9+, на старом окружении отчёт начнётся с них. И перед запуском с --fix сохраните копию конфига, если правили его вручную — config reset эти правки не пощадит.
Какие задачи решает
- прогнать диагностику установки Ruflo одной командой
- пересобрать базу памяти, когда она перестала открываться
- поднять демон, который не стартует
- вернуть конфиг к рабочему виду после неудачных правок
- проверить окружение перед первым запуском: Node.js 20+, npm 9+, git
Примеры запросов агенту
- Запусти ruflo-doctor и покажи, что именно сломано
- Прогони проверку Ruflo с
--fixи почини, что сможешь - Проверь установку Ruflo скиллом ruflo-doctor, потом перезапусти демон
Как установить ruflo-doctor
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code2Вручную: положить файлы
~/.claude/skills/ruflo-doctor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ruflo-doctor/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill ruflo-doctor -a codex2Вручную: положить файлы
.agents/skills/ruflo-doctor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill ruflo-doctor -a cursor2Вручную: положить файлы
.cursor/skills/ruflo-doctor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo ruflo-doctor2Вручную: положить файлы
.github/skills/ruflo-doctor/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill ruflo-doctor -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-core/skills/ruflo-doctorВручную: положить файлы
.devin/skills/ruflo-doctor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill ruflo-doctor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ruflo-doctor
Как установить ruflo-doctor в Claude Code?
Выполните npx skills add ruvnet/ruflo --skill ruflo-doctor -a claude-code. Файл скилла появится по пути ~/.claude/skills/ruflo-doctor/SKILL.md.
Что делает ruflo-doctor?
Запускает npx @claude-flow/cli@latest doctor --fix: проверяет окружение, конфиг, демон, базу памяти, MCP-серверы и чинит типовые поломки.
Что нужно, чтобы проверки проходили?
Node.js 20+ и npm 9+. На более старых версиях отчёт начнётся с ошибок окружения, и до остальных проверок дело может не дойти.
Исходный текст
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`
© ruvnet · MIT · ruvnet/ruflo