doctor

Solid

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).

AI & Automation 28 stars 3 forks Updated 1 weeks ago Apache-2.0

Install

View on GitHub

Quality Score: 83/100

Stars 20%
49
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 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 built-in checks, grouped into four sections: **Config** (onebrain.yml, onebrain.yml-keys, vault-config-migration, legacy-qmd-collection), **Vault structure** (folders, plugin-files, plugin-cache), **Integration** (settings-hooks, claude-settings), **Index & state** (orphan-checkpoints, search). Rust-native, single subprocess call, structured JSON output. (`search` replaced the v3.3 `qmd-embeddings` probe; `legacy-qmd-collection` migrates a top-level `qmd_collection` → `search.collection`.) - **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....

Details

Author
onebrain-ai
Repository
onebrain-ai/onebrain
Created
5 months ago
Last Updated
1 weeks ago
Language
Shell
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Listed

doctor

Foundry health check (/foundry:doctor) — a thin, five-check probe (the v0.25.0 test-suite realignment shrank this from a 2,900-line drop-in-check registry to one file). Checks the plugin manifest loads, hooks.json parses with every referenced hook script present, every skills/*/SKILL.md frontmatter YAML-parses, the stack-profile lock (if any) resolves, and the operator registry resolves. Fails CLOSED for an operator-invoked check (exit non-zero on any hard failure); the --session-start cadence is advisory (fail-open, never wedges a session). Trigger when the operator says "/foundry:doctor", "foundry health check", or to diagnose why a session looks unhealthy.

1 Updated 6 days ago
lukasrepublic
AI & Automation Listed

doctor

Cross-plugin system diagnostics for the claude-forge ecosystem. Checks installed plugins, hook compilation, duplicate hook detection, continuity system health, environment (Node, npm, VCS CLI), and log sizes. Use when: plugins seem broken, hooks are not firing, skills or agents have gone missing, after installing or updating plugins, or for periodic health checks. Triggers on: doctor, diagnose plugins, plugin health, hooks not working, skills missing, plugin not loading, system check, plugin status, what is installed, troubleshoot plugins

6 Updated 1 months ago
ArieGoldkin
AI & Automation Featured

doctor

OrchestKit doctor for health diagnostics across manifest integrity, hook configuration, skill validation, agent frontmatter, MCP server connectivity, CC version compatibility, and permission rules. Reports issues with severity levels and auto-remediation suggestions. Validates component counts, detects orphaned entries, and checks CC version matrix compliance. Use when diagnosing plugin health, troubleshooting configuration issues, or running pre-release checks.

229 Updated today
yonatangross