mcpField
C
cco-doctor

cco-doctor

github.com/egorfedorovAgent workflows125130 installsUpdated 1d ago
Repository

About cco-doctor

cco-doctor is a diagnostic skill for checking the health of a Claude plugin. It validates configuration, files, data, model budget settings, and the Node.js version, and can optionally run the unit tests.

Key features

  1. 01Plugin manifest and package checks
  2. 02Version consistency validation
  3. 03Hook configuration and script checks
  4. 04Data, settings, and stats validation
  5. 05Node.js version check
  6. 06Optional unit test run

Use cases

  1. 01Diagnose a plugin that is not working
  2. 02Check plugin setup before use
  3. 03Run health checks alongside unit tests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-doctor

After installing, type/cco-doctorin Claude Code to confirm it loaded.

Details

From the project README

CCO Doctor

When the user runs /cco-doctor or reports the plugin "isn't working", run a quick health check.

How to use

Standard run (fast — under 1s):

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js

With test suite (slower — runs all unit tests):

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js --tests

What it checks

  • Plugin manifest and package.json exist
  • Versions are in sync (plugin.json and package.json)
  • hooks.json is valid JSON with all expected event types
  • All hook scripts present in src/
  • Data directory ~/.claude-context-optimizer/ is writable
  • patterns.json size is reasonable
  • Global stats file is parseable
  • User config has sane model + budget for the chosen model
  • Node version meets the >=18 requirement

Presentation

Translate the doctor output into plain language. If anything is fail, walk the user through the fix:

  • versions out of sync → npm run sync-version
  • patterns.json too big → /cco-clean
  • budget > model window → /cco-budget set <smaller> or pick a 1M-context model (e.g. opus-5.5)
  • node too old → upgrade Node

If everything is pass, confirm "плагин в порядке, текущая версия Х.Y.Z" and stop.

Comments

Markdown supported