cco-config
View and tune CCO's behavior thresholds — re-read warnings, cache staleness, prompt-coach length bands, and the /cco-pack budget cap
How do I install this agent skill?
npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-configIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a configuration management tool for 'CCO', allowing users to view and tune operational thresholds. It functions by executing a local Node.js script to read from and write to a specific configuration file in the home directory, performing range validation on values to ensure integrity. No security issues or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
CCO Config — tune how aggressive the optimizer is
CCO's behavior knobs used to be magic numbers spread across four modules.
This surfaces them, range-validated, in ~/.claude-context-optimizer/config.json
under thresholds.
The plugin root is the directory containing src/config.js. Run everything
from there.
Parse $ARGUMENTS:
show (or no arguments)
node ${CLAUDE_PLUGIN_ROOT}/src/config.js
Print the table as-is. * marks values the user set; ! marks a stored value
that failed validation and is being ignored in favour of the default. If any
! rows appear, point them out — a typo there means a knob silently isn't
doing what the user thinks.
get <key>
node ${CLAUDE_PLUGIN_ROOT}/src/config.js get <key>
set <key> <value>
node ${CLAUDE_PLUGIN_ROOT}/src/config.js set <key> <value>
Exits non-zero with the valid range on a bad value or unknown key — relay that message rather than guessing a correction. After a successful set, say which behavior it changes (see the table below), because the effect is not obvious from the key name alone.
reset [key]
node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset <key> # one key
node ${CLAUDE_PLUGIN_ROOT}/src/config.js reset # everything back to defaults
Resetting everything discards all the user's tuning — confirm first unless they were explicit ("reset all", "вернуть всё по умолчанию").
The keys
| Key | Default | What it changes |
|---|---|---|
rereadWarnAt | 3 | reads of an unedited file before the first re-read warning |
rereadEscalateAt | 5 | reads before the "put it in CLAUDE.md" escalation |
bigFileLines | 500 | full-read line count that triggers the offset/limit warning |
mediumFileLines | 200 | full-read line count that triggers the soft hint |
staleTokenRatio | 0.10 | share of budget loaded after a file before Read Cache re-allows it |
staleFiles | 8 | other files loaded after a file before it counts as evicted (at 200K) |
staleTimeMs | 600000 | ms since last read before a cached file counts as stale |
promptMinWords | 8 | word count below which the coach calls a prompt too vague |
promptIdealMaxWords | 200 | upper bound of the coach's "ideal length" band |
promptTooLongWords | 500 | word count above which the ask is considered buried |
packBudgetPercent | 25 | max share of the budget /cco-pack may consume |
Tuning guidance
- Too many re-read warnings? Raise
rereadWarnAtto 4–5. - Read Cache blocking files you still need? Lower
staleTimeMs(e.g.300000= 5 min) orstaleTokenRatioso cached entries go stale sooner. - Read Cache not saving much? Raise them — entries stay fresh longer and more repeat reads get blocked.
- Working on a 1M-context model with long prompts? Raise
promptTooLongWords; the default band is tuned for shorter asks. CCO_STALE_TIME_MSin the environment still overridesstaleTimeMs, for a one-off experiment without changing config.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/egorfedorov/claude-context-optimizer/cco-config">View cco-config on skillZs</a>