eric-cielo/moflo / .claude/skills/healer
healer
VerifiedRun moflo's Healer (`flo healer`, alias for `flo doctor`) from inside the Claude session. Audit-only by default; pass `--fix` to apply auto-repairs, `-c <component>` for a single check. Use when something feels off (missing moflo.yaml, daemon dead, statusline empty, hooks not firing) or as a periodic health check. Distinct from Claude Code's built-in `/doctor`, which diagnoses Claude Code itself, not moflo.
/healer — moflo Installation Healer
Thin wrapper around the flo healer CLI. All check + fix logic lives in the CLI; this skill just shells out, surfaces results in-thread, and gives one-line follow-up nudges.
Arguments: $ARGUMENTS
Procedure
-
Memory first (gate requirement):
mcp__moflo__memory_search { query: "doctor healer fix moflo.yaml gate hook wiring", namespace: "guidance" } -
Run the CLI with the user's arguments passed through:
npx moflo healer --json $ARGUMENTS- No args → audit-only.
--fix→ CLI runs auto-repairs after the audit.-c <component>→ restricts to one check.- Always include
--jsonso output is machine-parseable.
-
Surface the JSON in-thread. Group by status:
✓ N passing(count only)⚠ warnings— listname: message; flag with[auto-fixable]when the result has afixfield✗ failures— same- If
--fixmode, readfixesApplied[]from the JSON payload and list{name, applied}per entry — applied=true → "fixed", applied=false → "needs manual action". Theresults[]array is post-fix state (re-evaluated), so report the final status. - If
--installwas passed, surfaceclaudeCodeInstall.installedfrom the payload. - If
--kill-zombieswas passed, surfacezombieScan.killed/zombieScan.foundfrom the payload.
-
Nudge based on what changed. Only mention next steps for state that actually changed:
- Daemon restarted →
Statusline should refresh within ~5s. moflo.yamlcreated →Review the new defaults at the project root before your next deep run.- Hook wiring repaired →
Restart Claude Code so the new SessionStart hook fires next launch. - In audit-only mode with auto-fixable issues →
Run /healer --fix to repair.
- Daemon restarted →
Rules
- Don't re-document checks or fixes here. The CLI's
--helpandsrc/cli/commands/doctor-*are the source of truth. - Don't call
flo doctordirectly — use thehealeralias for thematic consistency. They're equivalent CLI-side. - Don't swallow non-zero exit codes silently — surface them in the summary.
- Note for users: Claude Code has its own built-in
/doctorcommand that diagnoses Claude Code itself. This skill (/healer) diagnoses moflo, not Claude Code. The two are complementary, not duplicates. The healer rolls in the user-actionable parts ofclaude doctor(Claude Code version freshness vs npm latest) into its ownClaude Code CLIcheck; the rest ofclaude doctoris a TUI on current releases and must be run interactively if you need its full report.
See Also
flo doctor --help— full flag/component list/eldar— broader project-setup audit; consults the Healer as one input
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |