Updated 2mo ago
by sup3x
claude-code-eco
Eco mode for Claude Code. /eco: -31% to -73% output tokens with critical findings intact; /eco-max: up to -75% with lowered effort. Measured hardest on Claude Fable 5 (fable5), deep-studied on Sonnet 5, works on Opus 4.8 too. We publish our negative results. 82 raw benchmark runs.
39 GitHub stars (39)
Steady at 39 stars — no new stars in the 16 days since Sep 30.
- 4 skills (4 skills found in its SKILL.md files)
- 1 forks (1 forks)
- 2mo ago last update (Last updated 2mo ago)
Install
Skills CLI
npx skills add sup3x/claude-code-eco
Asks which skills and agents to install. Just one: npx skills add sup3x/claude-code-eco --skill eco-audit — add -g for every project.
Claude Code
git clone https://github.com/sup3x/claude-code-ecocp -r "claude-code-eco/skills/eco-audit" ~/.claude/skills/
Copies the eco-audit skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add sup3x/claude-code-eco
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
eco-audit
Audit this machine's Claude Code configuration for token waste - effort level, oversized CLAUDE.md files, MCP servers, tool-output caps, env keys that do nothing, startup skill load - and print the exact settings.json edit that fixes each finding. Read-only; it never writes settings. Use when the user asks why their usage or bill is high, or wants a config, context or startup-cost checkup, in any…
skills/eco-audit/SKILL.md on GitHub (opens in a new tab) -
eco-max
Maximum-savings variant of /eco - the same frugality rules PLUS a low reasoning-effort override for the invoked task. Use for routine chores (rename, small fix, quick question, boilerplate) when the user wants absolute minimum token spend; prefer plain /eco for hard or high-stakes work. Works in any language.
skills/eco-max/SKILL.md on GitHub (opens in a new tab) -
eco-report
Show where the tokens actually went - per-session output, thinking, input and cache accounting read from this machine's Claude Code transcripts. Use when the user asks what they spent, which sessions were expensive, how their prompt cache is doing, or whether /eco is helping. Works in any language.
skills/eco-report/SKILL.md on GitHub (opens in a new tab) -
eco
Token-frugal mode - minimize token consumption (concise replies, lean tool use, cheap delegation) at full task quality. Use when the user mentions tokens, cost, budget, quota, or economical operation, in any language. Invoke once; applies for the rest of the session. "/eco setup" configures permanent savings.
skills/eco/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.