Show what tools actually cost in tokens — learned per-tool averages from observed results, replacing the hardcoded MCP/Agent guesses

MITAuto-check passedAgent Workflows

Install Cco Tools

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

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

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

At a glance

Show what tools actually cost in tokens — learned per-tool averages from observed results, replacing the hardcoded MCP/Agent guesses

  • Agent Workflows work in your project
  • SKILL.md covers show (or no arguments) and reset
  • Calls node

What it does

Cco Tools is an agent skill from egorfedorov/claude-context-optimizer. Show what tools actually cost in tokens — learned per-tool averages from observed results, replacing the hardcoded MCP/Agent guesses

Its SKILL.md is about 470 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 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

  • Agent Workflows work in your project

Example prompts

  • “/cco-tools”

Requirements

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

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/tool-costs.js:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    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 Tools loads about 474 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 236 words of instructions outside code blocks.

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

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). 236 words, ~474 tokens.

Download SKILL.mdSave it as .claude/skills/cco-tools/SKILL.md (or your agent's skills folder).
name
cco-tools
description
Show what tools actually cost in tokens — learned per-tool averages from observed results, replacing the hardcoded MCP/Agent guesses
allowed-tools
Bash(node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js:*)
license
MIT
argument-hint
[show | reset]

CCO Tools — what your tools really cost

MCP and Agent token costs used to be constants picked once (mcp__* ≈ 200 in, Agent ≈ 500). Real results vary by orders of magnitude — a "list all issues" query and a one-row lookup are the same tool name and nowhere near the same cost. On MCP-heavy sessions the budget meter was guessing at its biggest line item.

CCO now measures every tool result and learns the average per tool name.

Run from the plugin root:

show (or no arguments)

bash
node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js

Prints the learned table: calls, average, worst case, and cumulative total per tool, sorted by total spend.

When reading it back to the user, the useful observations are:

  • The top row by total is where their context budget actually goes. It is frequently an MCP server rather than file reads.
  • A row marked · has fewer than 3 samples and is still using the built-in constant — its estimate isn't trustworthy yet.
  • A large gap between avg and max means that tool is unpredictable; suggest narrowing its queries (filters, limits, pagination) rather than dropping it.

Pair with /cco-overhead mcp — that shows which servers are configured but never called; this shows what the called ones actually cost.

reset

bash
node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js reset

Clears the learned table and returns every tool to its built-in constant. Useful after changing MCP servers or their configuration, when past measurements no longer describe the current setup. Confirm before running — the history isn't recoverable.

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

Open the folder on GitHubat commit f6f20ee

Compare with similar skills

Cco Tools 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 Tools compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cco Tools this skillegorfedorov/claude-context-optimizer114—~474Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • 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 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k 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 9 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 9 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 9 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 9 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 9 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 9 days ago
    Auto-check passed

Categories

Questions about Cco Tools

What does Cco Tools do?

Show what tools actually cost in tokens — learned per-tool averages from observed results, replacing the hardcoded MCP/Agent guesses. Cco Tools is an agent skill from egorfedorov/claude-context-optimizer.

When should I use Cco Tools?

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

How do I install Cco Tools in Claude Code?

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

How do I install Cco Tools in Codex?

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

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

What does Cco Tools need to run?

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

Does Cco Tools 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 Tools 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 Tools use?

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

About 474 tokens (SKILL.md is roughly 1.9k 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 Tools?

Skills that share tags, products or a category with Cco Tools: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cco Tools?

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.