Audit the fixed context overhead every session starts with — system prompt, MCP tools, agents, CLAUDE.md, memory — measured from real transcript usage

MITAuto-check passedAgent Workflows

Install Cco Overhead

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

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

GitHub CLI
$ gh skill install egorfedorov/claude-context-optimizer cco-overhead --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-overhead .claude/skills/cco-overhead && 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-overhead
GitHub stars
114
Token cost
~606 tokens
SKILL.md length
310 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Audit the fixed context overhead every session starts with — system prompt, MCP tools, agents, CLAUDE.md, memory — measured from real transcript usage

  • Works in 4 steps: Baseline — exact context size at the… → Cost per session — what that baseline… → Itemization — the locally measurable… → …
  • Tasks that involve Prompt engineering
  • Calls node and claude
  • Tasks that involve MCP servers

What it does

Cco Overhead is an agent skill from egorfedorov/claude-context-optimizer. Audit the fixed context overhead every session starts with — system prompt, MCP tools, agents, CLAUDE.md, memory — measured from real transcript usage

Its SKILL.md is about 610 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, covering Prompt engineering, MCP servers and Agent instruction files. It works with Model Context Protocol. 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

  • Tasks that involve Prompt engineering
  • Tasks that involve MCP servers
  • Tasks that involve Agent instruction files

Example prompts

  • “/cco-overhead”

Requirements

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

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Baseline — exact context size at the first assistant response (from the
  2. Cost per session — what that baseline costs to write into the prompt
  3. Itemization — the locally measurable parts (project + global CLAUDE.md,
  4. Recommendations — what to trim and how (e.g. /cco-claudemd, disabling

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/overhead.js:*)
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node
    • claude

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

  • Network

    No URLs in SKILL.md.

    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 Overhead loads about 606 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 310 words of instructions outside code blocks.

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

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). 310 words, ~606 tokens.

Download SKILL.mdSave it as .claude/skills/cco-overhead/SKILL.md (or your agent's skills folder).
name
cco-overhead
description
Audit the fixed context overhead every session starts with — system prompt, MCP tools, agents, CLAUDE.md, memory — measured from real transcript usage
allowed-tools
Bash(node ${CLAUDE_PLUGIN_ROOT}/src/overhead.js:*), Read
license
MIT

Session Baseline Overhead Audit

Measure how many tokens every session of this project pays BEFORE any work happens — and where to cut.

Run:

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

The report shows:

  1. Baseline — exact context size at the first assistant response (from the session transcript's API usage counts), latest and averaged over recent sessions, as a % of the working budget.
  2. Cost per session — what that baseline costs to write into the prompt cache each session.
  3. Itemization — the locally measurable parts (project + global CLAUDE.md, memory index, agent definitions) and the unattributed remainder (system prompt, tool schemas, MCP servers).
  4. Recommendations — what to trim and how (e.g. /cco-claudemd, disabling unused MCP servers, pruning agent descriptions).

Then run the MCP usage audit — it turns 30 days of tracked tool calls into per-server verdicts and the EXACT removal command for servers that were never called:

bash
node ${CLAUDE_PLUGIN_ROOT}/src/overhead.js mcp --servers <name1>,<name2>

Pass the MCP server names from your own tool list (mcp__<server>__*, one entry per server). The script never reads ~/.claude.json — it holds account data — so it only knows the servers you pass plus the project's ./.mcp.json.

Only if the report actually prints claude mcp remove ... commands, OFFER to run them for the user (each removal repays in every future session; claude mcp add restores any time). Only run them after the user agrees.

If a server is listed as ? not observed, the tracker has no MCP data yet — that is not a verdict. Never suggest removing those servers, and never construct a claude mcp remove command the report did not print.

Present the output to the user as-is (it is already formatted). If the report says no transcripts were found, explain that the audit needs at least one completed exchange in a session for this project.

Key framing for the user: baseline overhead is paid in EVERY session, so a one-time trim repays itself continuously — it is usually the highest-leverage optimization available.

© 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-overhead of egorfedorov/claude-context-optimizer.

Open the folder on GitHubat commit f6f20ee

Compare with similar skills

Cco Overhead 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 Overhead compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cco Overhead this skillegorfedorov/claude-context-optimizer114—~606Automated safety check: PassMIT
Workflow Schema Tuningbreaking-brake/cc-wf-studio5.4k—~1.3kAutomated safety check: PassCustom licence
Clawmemyoloshii/ClawMem210—~7.5kAutomated safety check: PassMIT
AI Bomcdxgen/cdxgen1.1k—~2.5kAutomated safety check: PassApache-2.0
Add Promptcyanheads/pubmed-mcp-server158—~1.6kAutomated safety check: PassApache-2.0
MCP Developmentrohitg00/awesome-claude-code-toolkit2.7k—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • Workflow Schema Tuning

    breaking-brake/cc-wf-studio

    Guides edits to cc-wf-studio's workflow schema so AI agents generate better workflows, treating schema text as prompt engineering rather than validation.

    5.4k GitHub stars~1.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Clawmem

    yoloshii/ClawMem

    ClawMem operational reference for agents at query time — the 3-rule escalation gate, MCP tool routing, the 4 query-optimization levers, pipeline behavior (query vs intentsearch), composite scoring…

    210 GitHub stars~7.5k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • AI Bom

    cdxgen/cdxgen

    Generates AI-BOM, MCP inventory, AI skill inventory, and AI authorship provenance documents with cdxgen, cataloging models, inference services, Hugging Face purls, MCP servers and their…

    1.1k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Add Prompt

    cyanheads/pubmed-mcp-server

    Scaffold a new MCP prompt template. An agent skill from cyanheads/pubmed-mcp-server.

    158 GitHub stars~1.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • MCP Development

    rohitg00/awesome-claude-code-toolkit

    MCP server development including tool design, resource endpoints, prompt templates, and transport configuration

    2.7k GitHub stars~1.2k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Spring AI MCP Server Patterns

    giuseppe-trisciuoglio/developer-kit

    Provides Spring Boot MCP server patterns that create Model Context Protocol servers with Spring AI by defining tool handlers, exposing resources, configuring prompt templates, and setting up…

    357 GitHub stars~2.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check: notes

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 10 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 10 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 10 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 10 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 10 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 10 days ago
    Auto-check passed

Questions about Cco Overhead

What does Cco Overhead do?

Audit the fixed context overhead every session starts with — system prompt, MCP tools, agents, CLAUDE.md, memory — measured from real transcript usage. Cco Overhead is an agent skill from egorfedorov/claude-context-optimizer.

When should I use Cco Overhead?

Cco Overhead fits situations like: tasks that involve Prompt engineering; tasks that involve MCP servers; tasks that involve Agent instruction files.

How do I install Cco Overhead in Claude Code?

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

How do I install Cco Overhead in Codex?

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

Can I use Cco Overhead 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-overhead -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-overhead, .gemini/skills/cco-overhead, .github/skills/cco-overhead and .opencode/skills/cco-overhead in your project.

What does Cco Overhead need to run?

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

Does Cco Overhead access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cco Overhead 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 Overhead use?

Cco Overhead 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 Overhead use?

About 606 tokens (SKILL.md is roughly 2.4k 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 Overhead?

Skills that share tags, products or a category with Cco Overhead: Workflow Schema Tuning (breaking-brake/cc-wf-studio, 5.4k stars), Clawmem (yoloshii/ClawMem, 210 stars), AI Bom (cdxgen/cdxgen, 1.1k stars) and Add Prompt (cyanheads/pubmed-mcp-server, 158 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cco Overhead?

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.