# Flow Doctor

> Repair the current flow's runtime assets first; if the fault is in butler-flow code, emit diagnosis + fix plan and request pause.

- Skill: `ocean326/flow-doctor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ocean326/flow-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ocean326/flow-doctor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ocean326 (https://skillmd.com/u/ocean326)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ocean326/flow-doctor

---


# Flow Doctor

## Recovery order

1. Validate current flow runtime bindings and local sidecars.
2. Repair instance-local assets before suggesting broader action.
3. If the fault is a framework bug, do not fake recovery; output `DOCTOR_FRAMEWORK_BUG:` with diagnosis and fix plan.

## Allowed repairs

- Clear or reseed invalid role/session bindings.
- Repair missing `flow_definition.json` or instance bundle files for the current flow.
- Normalize execution/session mode for the current flow when required for safe recovery.

## Forbidden

- Do not rewrite global templates, role catalogs, or unrelated repo code from inside the flow.