---
name: Context Mode Doctor
slug: context-mode-doctor
category: DevOps
description: Context Mode Doctor runs diagnostics on the Context Mode plugin and reports the status of runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. Use it to troubleshoot Context Mode installations and verify all components are working correctly.
github: "https://github.com/mksglu/context-mode/tree/main/skills/ctx-doctor"
language: TypeScript
stars: 19850
forks: 1430
install: "npx degit https://github.com/mksglu/context-mode/tree/main/skills/ctx-doctor ~/.claude/skills/ctx-doctor"
installs_to: ~/.claude/skills/ctx-doctor
source_path: skills/ctx-doctor/SKILL.md
collection_size: 11
category_size: 798
collection_url: "https://dirskills.com/collections/mksglu/context-mode"
added: 2026-08-14T07:12:38.936Z
last_synced: 2026-08-14T07:12:38.936Z
canonical_url: "https://dirskills.com/skills/context-mode-doctor"
---

# Context Mode Doctor

Context Mode Doctor runs diagnostics on the Context Mode plugin and reports the status of runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. Use it to troubleshoot Context Mode installations and verify all components are working correctly.

**Install:**

```bash
npx degit https://github.com/mksglu/context-mode/tree/main/skills/ctx-doctor ~/.claude/skills/ctx-doctor
```

## README

# Context Mode Doctor

Run diagnostics and display results directly in the conversation.

## Instructions

1. Call the `ctx_doctor` MCP tool directly. It runs all checks server-side and returns a plain-text status report.
2. Display the results verbatim — they are already formatted with plain-text status prefixes: `[OK]` PASS, `[FAIL]` FAIL, `[WARN]` WARN. Renderer-safe (no markdown task-list syntax) for cross-client compatibility (e.g., Z.ai GLM).
3. **Fallback** (only if MCP tool call fails): Derive the **plugin root** from this skill's base directory (go up 2 levels — remove `/skills/ctx-doctor`), then run with Bash:
   ```
   CLI="<PLUGIN_ROOT>/cli.bundle.mjs"; [ ! -f "$CLI" ] && CLI="<PLUGIN_ROOT>/build/cli.js"; node "$CLI" doctor
   ```
   Re-display results verbatim with the same `[OK]`/`[FAIL]`/`[WARN]` prefixes.