Ctx Doctor
- 840 installs
- 19.6k repo stars
- Updated August 4, 2026
- mksglu/context-mode
ctx-doctor is a Debugging skill that runs Context Mode health checks via the ctx_doctor MCP tool for developers verifying hooks, FTS5, and plugin registration in Claude or Cursor.
About
ctx-doctor is a Debugging skill for the Context Mode plugin that runs server-side diagnostics through the ctx_doctor MCP tool and returns a plain-text status report in the conversation. Checks cover runtimes, hooks, FTS5 indexing, plugin registration, and npm plus marketplace versions, labeled with [OK], [FAIL], and [WARN] prefixes for cross-client rendering. Developers invoke ctx-doctor with `/context-mode:ctx-doctor` when Context Mode search, hooks, or registration fails inside Claude or Cursor. The skill displays results verbatim without markdown task-list syntax for compatibility with clients like Z.ai GLM. ctx-doctor fits operators who need a single-pass health report before debugging configuration files or reinstalling marketplace packages, reducing guesswork when context retrieval silently degrades.
- Runs full server-side diagnostics via MCP tool call
- Checks runtimes, hooks, FTS5, plugin registration, npm and marketplace versions
- Outputs clean [OK], [FAIL], [WARN] prefixed report compatible with any client
- Includes automatic fallback to local CLI when MCP is unavailable
- Triggerable with /context-mode:ctx-doctor
Ctx Doctor by the numbers
- 840 all-time installs (skills.sh)
- +92 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #1,289 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/mksglu/context-mode --skill ctx-doctorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 840 |
|---|---|
| repo stars | ★ 19.6k |
| Last updated | August 4, 2026 |
| Repository | mksglu/context-mode ↗ |
How do you diagnose Context Mode installation issues?
Diagnose and verify that Context Mode is correctly installed, registered, and functioning inside their Claude or Cursor workspace.
Who is it for?
Developers running Context Mode in Claude or Cursor who need a one-command health check before debugging hooks or FTS5 search failures.
Skip if: General application log debugging or projects that do not use the Context Mode plugin and its MCP tooling.
When should I use this skill?
The user runs /context-mode:ctx-doctor or reports Context Mode hooks, FTS5 search, or plugin registration failures.
What you get
Plain-text diagnostic report with [OK], [FAIL], and [WARN] status for runtimes, hooks, FTS5, and plugin versions.
- plain-text diagnostic status report
By the numbers
- Checks 5 areas: runtimes, hooks, FTS5, plugin registration, and npm/marketplace versions
Files
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" doctorRe-display results verbatim with the same [OK]/[FAIL]/[WARN] prefixes.
Related skills
Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k
Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k
CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k
Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k
Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72
Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10How it compares
Pick ctx-doctor over generic log-analysis skills when the failure is Context Mode plugin health, not application runtime logs.
FAQ
How do you run ctx-doctor?
ctx-doctor is user-invocable with `/context-mode:ctx-doctor`, which calls the ctx_doctor MCP tool server-side and prints a plain-text report with [OK], [FAIL], and [WARN] lines.
What does ctx-doctor check?
ctx-doctor verifies Context Mode runtimes, hooks, FTS5 indexing, plugin registration, and npm plus marketplace versions, surfacing pass, fail, and warning states in one report.
Why does ctx-doctor avoid markdown task lists?
ctx-doctor displays MCP results verbatim using plain-text prefixes so diagnostics render consistently across clients, including Z.ai GLM, without markdown checkbox syntax breaking.