← ClaudeAtlas

doctorlisted

Diagnose vault and plugin health — checks broken links, orphan notes, stale memory/ files, inbox backlog, and plugin config validity. Use when the user asks to check vault health, notices something broken, or wants a system audit — 'run /doctor', 'check my vault', 'something seems off'. Do NOT use for: searching vault content (search directly), processing inbox (use consolidate), or updating the system (use update).
onebrain-ai/onebrain · ★ 10 · AI & Automation · score 79
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