Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

ctx-doctor — Claude Code skill: what it does, how to install

Runs context-mode health checks directly inside your agent session. It inspects runtimes, hooks, FTS5, and package versions to troubleshoot setup issues.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mksglu/context-mode --skill ctx-doctor -a claude-code
Open on GitHub

What ctx-doctor does

The skill queries the server-side ctx_doctor MCP tool to produce a status log. Each diagnostic check gets marked with [OK], [FAIL], or [WARN] text tags. The output avoids markdown task-list syntax deliberately, so clients like Z.ai GLM render the output without broken widgets. It tests runtime components, plugin registration, hooks, FTS5 database support, plus npm and marketplace version parity.

When the MCP tool call fails, the skill switches to a Bash fallback. It navigates two folders up to locate the plugin root, then runs node against cli.bundle.mjs or build/cli.js. Because the fallback relies on Node.js directly on your path, a missing runtime will break offline troubleshooting.

What it helps with

  • verify context-mode plugin registration and active hooks
  • check sqlite FTS5 availability in the current environment
  • compare installed npm package versions against the marketplace
  • run offline health checks via the local Node.js CLI when MCP fails

Example prompts for the agent

  • /context-mode:ctx-doctor
  • Run health checks for context-mode using /context-mode:ctx-doctor
  • Check FTS5 and hook status with /context-mode:ctx-doctor

How to install ctx-doctor

1Skills CLI (Vercel)

npx skills add mksglu/context-mode --skill ctx-doctor -a claude-code

2Manually: put the files in place

~/.claude/skills/ctx-doctor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ctx-doctor/

From the same set7

The whole set →

Similar

dart-setup-ffi-assets flutter Skill guides agents in automating compilation and packaging of C/C++ code into dynamic or static libraries via Dart's Native Assets system. Use it to integrate native code into Flutter or Dart packages. Claude Code CX Codex Cursor +1 13,800installs korean-jangbu-for NomaDamas Skill for automating microbusiness accounting in Korea: import bank data, tag transactions, generate tax consultant reports and management summaries. Claude Code CX Codex Cursor +1 6,000installs k-skill-cleaner NomaDamas Analyzes coding-agent skill trigger counts and interviews the developer to recommend unused K-skills for removal. Claude Code CX Codex Cursor +1 6,000installs case-review zhaoxuya520 Audits a reverse engineering case package for handoff: verifies Evidence to Finding and Path traceability, checks artifact hash integrity, and generates a report without modifying the case. Claude Code CX Codex Cursor +1 926installs nano-banana-2 prime-skills Skill to quickly generate images via Google Nano Banana 2 on RunComfy. Includes optimized prompting patterns, in-image typography support, and web grounding. Claude Code CX Codex Cursor +1 437,300installs image-edit prime-skills This skill routes image edits to a suitable RunComfy model. Use it for background swaps, text changes, masks, or batch work. Claude Code CX Codex Cursor +1 436,800installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs

Questions about ctx-doctor

How do I install ctx-doctor in Claude Code?

Run npx skills add mksglu/context-mode --skill ctx-doctor -a claude-code in your terminal.

What does ctx-doctor verify?

It validates environment runtimes, active hooks, sqlite FTS5 capabilities, plugin registration, and version matching between npm and the marketplace.

What happens if the ctx_doctor MCP tool fails?

The skill falls back to executing node <PLUGIN_ROOT>/cli.bundle.mjs doctor or build/cli.js via Bash to print the same text report.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor