Health check for the context-optimizer plugin install — verifies versions, hooks, data dir, model config, and reports any issues

MITAuto-check passedAgent Workflows

Install Cco Doctor

skills CLI
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install egorfedorov/claude-context-optimizer cco-doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cco-doctor .claude/skills/cco-doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cco-doctor
GitHub stars
114
Token cost
~364 tokens
SKILL.md length
154 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Health check for the context-optimizer plugin install — verifies versions, hooks, data dir, model config, and reports any issues

  • Agent Workflows work in your project
  • SKILL.md covers How to use, What it checks and Presentation
  • Calls node and npm

What it does

Cco Doctor is an agent skill from egorfedorov/claude-context-optimizer. Health check for the context-optimizer plugin install — verifies versions, hooks, data dir, model config, and reports any issues

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with npm. The repository describes itself as: Claude Code plugin that tracks token usage, identifies wasted context, and saves 30-50% on API costs. Heatmaps, ROI reports, budget alerts, efficiency scores, git-aware… The licence is MIT.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/cco-doctor”

Requirements

  • Pre-approved tools (allowed-tools): Bash(node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js:*), Read

What it can do on your machine

Read from SKILL.md and the folder at commit f6f20ee. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cco Doctor loads about 364 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~364

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from egorfedorov/claude-context-optimizer at commit f6f20ee, republished under its MIT licence (© egorfedorov). 154 words, ~364 tokens.

Download SKILL.mdSave it as .claude/skills/cco-doctor/SKILL.md (or your agent's skills folder).
name
cco-doctor
description
Health check for the context-optimizer plugin install — verifies versions, hooks, data dir, model config, and reports any issues
allowed-tools
Bash(node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js:*), Read
license
MIT

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):

bash
node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js

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

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

© egorfedorov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cco-doctor of egorfedorov/claude-context-optimizer.

Open the folder on GitHubat commit f6f20ee

Compare with similar skills

Cco Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cco Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cco Doctor this skillegorfedorov/claude-context-optimizer114—~364Automated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
CodeGraph Agent Evalcolbymchenry/codegraph74k—~950Automated safety check: PassMIT
Mem0 CLI Memory Commandsmem0ai/mem067k—~2kAutomated safety check: NotesApache-2.0
Orca Run Replayiflytek/skillhub5.2k4 repos~3kAutomated safety check: PassApache-2.0
Helmor Bump Vendorsdohooo/helmor1.3k—~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    74k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Adds, searches, lists, updates and deletes memories on the Mem0 platform from the terminal with the mem0 command, including a JSON mode built for agents.

    67k GitHub stars~2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: notes
  • Orca Run Replay

    iflytek/skillhub

    Answers questions about a past agent run from its recording, using causal graphs and replay, instead of reconstructing events from memory.

    5.2k GitHub starsUsed in 4 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • Helmor Bump Vendors

    dohooo/helmor

    Bump or upgrade the pinned versions of Helmor's bundled agent CLIs, SDKs, and supporting binaries — Claude Code + claude-agent-sdk (lockstep), Codex, Cursor SDK, OpenCode, Kimi, Pi, and gh / glab /…

    1.3k GitHub stars~2.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Paseo Help

    getpaseo/paseo

    Answers questions about the Paseo app, such as setup, providers, connectivity, updates and logs, by checking the current public docs and working out which daemon is involved.

    20k GitHub stars~1.6k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from egorfedorov/claude-context-optimizer

All 13 skills in this repo
  • Smart Loader

    egorfedorov/claude-context-optimizer

    Automatically suggests optimal files to preload based on the user's task description and historical context patterns.

    114 GitHub stars~530 tokensUpdated 11 days ago
    Auto-check passed
  • Cco

    egorfedorov/claude-context-optimizer

    Context Control Center — one screen for budget, $ spent, tokens saved, waste, last prompt grade, the active task, and ready-to-run optimization actions

    114 GitHub stars~465 tokensUpdated 11 days ago
    Auto-check passed
  • Cco Budget

    egorfedorov/claude-context-optimizer

    Configure token budget limits, auto-compact settings, and view current budget status (model-aware — Claude 5 lineup, Opus 5.5 default fallback, full 1M context at standard price)

    114 GitHub stars~808 tokensUpdated 11 days ago
    Auto-check passed
  • Cco Config

    egorfedorov/claude-context-optimizer

    View and tune CCO's behavior thresholds — re-read warnings, cache staleness, prompt-coach length bands, and the /cco-pack budget cap

    114 GitHub stars~839 tokensUpdated 11 days ago
    Auto-check passed
  • Cco Patterns

    egorfedorov/claude-context-optimizer

    Share learned file patterns across a team — export an anonymized digest of what's usually waste/useful/co-edited, and import a teammate's so a fresh clone benefits day one

    114 GitHub stars~665 tokensUpdated 11 days ago
    Auto-check passed
  • Cco Shield

    egorfedorov/claude-context-optimizer

    Show ContextShield status and waste protection stats; suggest or apply .contextignore rules from historical waste

    114 GitHub stars~457 tokensUpdated 11 days ago
    Auto-check passed

Works with

Categories

Questions about Cco Doctor

What does Cco Doctor do?

Health check for the context-optimizer plugin install — verifies versions, hooks, data dir, model config, and reports any issues. Cco Doctor is an agent skill from egorfedorov/claude-context-optimizer.

When should I use Cco Doctor?

Cco Doctor fits situations like: agent Workflows work in your project.

How do I install Cco Doctor in Claude Code?

Run `npx skills add egorfedorov/claude-context-optimizer --skill cco-doctor -a claude-code`. Or copy the skill folder (skills/cco-doctor in egorfedorov/claude-context-optimizer) into .claude/skills/cco-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Cco Doctor in Codex?

Run `npx skills add egorfedorov/claude-context-optimizer --skill cco-doctor -a codex`. Or copy the skill folder (skills/cco-doctor in egorfedorov/claude-context-optimizer) into .agents/skills/cco-doctor in your project. Codex loads it when a task matches its description.

Can I use Cco Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add egorfedorov/claude-context-optimizer --skill cco-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cco-doctor, .gemini/skills/cco-doctor, .github/skills/cco-doctor and .opencode/skills/cco-doctor in your project.

What does Cco Doctor need to run?

Going by SKILL.md and its folder, Cco Doctor needs the command-line tools its instructions call (node and npm). Its frontmatter pre-approves these tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js:*), Read.

Does Cco Doctor access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cco Doctor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cco Doctor use?

Cco Doctor is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cco Doctor use?

About 364 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cco Doctor?

Skills that share tags, products or a category with Cco Doctor: MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), CodeGraph Agent Eval (colbymchenry/codegraph, 74k stars), Mem0 CLI Memory Commands (mem0ai/mem0, 67k stars) and Orca Run Replay (iflytek/skillhub, 5.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cco Doctor?

egorfedorov (a GitHub user) maintains it in egorfedorov/claude-context-optimizer, which has 114 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: egorfedorov/claude-context-optimizer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.