Skip to content
Skill

Doctor

Diagnose vault and plugin health — checks broken links, orphan notes, stale memory/ files, inbox backlog, and plugin config validity

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
31
Last commit
3 months ago
License
Apache-2.0
Listing updated
today

When your agent uses it

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

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 4 files (35 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

This skill ships in the onebrain plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

/plugin marketplace add onebrain-ai/onebrain
/plugin install onebrain@onebrain

Or copy only this skill to ~/.claude/skills/doctor:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/onebrain-ai/onebrain.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/doctor &&
cp -R "$tmp/.claude/plugins/onebrain/skills/doctor" ~/.claude/skills/doctor &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/doctor inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/doctor to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/onebrain-ai/onebrain.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/doctor &&
cp -R "$tmp/.claude/plugins/onebrain/skills/doctor" ~/.agents/skills/doctor &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/doctor inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/doctor to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/onebrain-ai/onebrain.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/doctor &&
cp -R "$tmp/.claude/plugins/onebrain/skills/doctor" ~/.cursor/skills/doctor &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/doctor inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/onebrain-ai/onebrain.git --path .claude/plugins/onebrain/skills/doctor

Or copy the folder to ~/.gemini/skills/doctor yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/doctor:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/onebrain-ai/onebrain.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/doctor &&
cp -R "$tmp/.claude/plugins/onebrain/skills/doctor" ~/.copilot/skills/doctor &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/doctor inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/onebrain-ai/onebrain.git

Then copy onebrain/.claude/plugins/onebrain/skills/doctor into your agent's skills folder as doctor. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Doctor FAQ

How do I install Doctor in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/doctor to use it in all your projects, or to .claude/skills/doctor in one project. Or install the onebrain plugin, which includes it: /plugin marketplace add onebrain-ai/onebrain, then /plugin install onebrain@onebrain.

Does Doctor run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Doctor?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

What are the best alternatives to Doctor?

The closest alternatives to Doctor are Claude API, Qdrant horizontal scaling, Pinecone rag, Qdrant memory usage optimization and Qdrant scaling query volume.

More from onebrain-ai/onebrain

  1. Quick URL bookmark capture : paste a link, AI generates name and description, suggests category, saves to Bookmarks.md in awesome-list forma

    • Open source
    • 31 GitHub stars
  2. Capture a stream of raw thoughts : classify them and file to inbox with action items extracted

    • Open source
    • 31 GitHub stars
  3. Quick note capture with automatic wikilink suggestions to related existing notes

    • Open source
    • 31 GitHub stars
  4. Clone your agent's portable context (agent folder including MEMORY.md) to a folder for transfer to another vault

    • Open source
    • 31 GitHub stars
  5. Find connections between notes and suggest wikilinks to strengthen the knowledge graph

    • Open source
    • 31 GitHub stars
    • Knowledge and memory
  6. Review inbox and recent notes, synthesize and merge into the knowledge base

    • Open source
    • 31 GitHub stars
    • Knowledge and memory

Alternatives to Doctor

  1. Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model

    • 196K GitHub stars
    • AI models and LLM tooling
  2. Diagnoses and guides Qdrant horizontal scaling decisions

    • Open source
    • 41.3K GitHub stars
    • Knowledge and memory
  3. Build production RAG pipelines and persistent agent memory using Pinecone as the vector database backend

    • Open source
    • 41.3K GitHub stars
    • Knowledge and memory