# Ctx Doctor

Run context-mode diagnostics.

- Repository: https://github.com/mksglu/context-mode (33152 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mksglu/context-mode --skill ctx-doctor -g -a claude-code -y`
Codex: `npx skills add mksglu/context-mode --skill ctx-doctor -g -a codex -y`
Cursor: `npx skills add mksglu/context-mode --skill ctx-doctor -g -a cursor -y`
Gemini CLI: `npx skills add mksglu/context-mode --skill ctx-doctor -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add mksglu/context-mode`

## Description

Run context-mode diagnostics. Checks runtimes, hooks, FTS5, plugin registration, npm and marketplace versions. Trigger: /context-mode:ctx-doctor

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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