doctorlisted
Install: claude install-skill onebrain-ai/onebrain
# Doctor
Diagnose the health of your OneBrain vault and plugin configuration. Inspired by `brew doctor` and `npm doctor`.
Usage:
- `/doctor` — full check (vault + config + memory)
- `/doctor --vault` — vault content checks only (skips CLI doctor)
- `/doctor --config` — plugin config + CLI doctor only (skips vault content)
- `/doctor --fix` — auto-fix safe issues (CLI fix recipes + skill fixes)
**Flag detection:** Determine active flags from the user's message. `--vault` = user mentions vault-only or content health; `--config` = user mentions config or plugin check; `--fix` = user explicitly asks to fix or auto-fix. Default (no flags) = run all checks.
**Two-source architecture** (post-v3.0.0 GA):
- **CLI doctor** (`onebrain doctor --json`) handles the 8 built-in checks: onebrain.yml, onebrain.yml-keys, folders, plugin-files, settings-hooks, orphan-checkpoints, qmd-embeddings, claude-settings. Rust-native, single subprocess call, structured JSON output.
- **Skill checks** handle vault-content + state-machine checks the CLI doesn't cover: broken wikilinks, orphan notes, stale memory/ files, MEMORY.md size, inbox backlog, log folder size, scheduler health, pause-thread state, memory health.
The skill merges both into one unified report.
---
## Step 1: Read onebrain.yml
Read `onebrain.yml`. If it's missing → ⛔ `onebrain.yml not found — OneBrain may not be configured correctly.` Stop.
Resolve folder variables (`[inbox_folder]`, `[projects_folder]`, etc.) from onebrain.yml