agentleFS
peleg-jpgpeleg-jpg/claude-code-frugal/SKILL.md

frugal

Skill1 starsChanged 4 months agoMITView on GitHub

Token-frugality operating mode for expensive high-intelligence models (Fable 5, Opus). Cuts model usage 30-60% with near-zero quality loss by defaulting to low thinking, searching before reading, filtering instead of scanning, and keeping context lean. Invoke this skill whenever the user says "frugal", "frugal mode", "save tokens", "less tokens", "low cost", "cheap mode", "minimize usage", "don't waste usage", runs "/frugal", OR is running on Fable 5 / any pricey model and wants to keep the bill down - even if they don't name the skill. Also use when they ask why usage is high or how to reduce it. Once active it stays active every response, like caveman mode.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. udaysharmadev/Skills★ 12same name
    2. fainir/frugal★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    2. Search before you read: Never read a large file start to finish.

    line 45
  2. Distinctive:

    5. Keep the context lean - audit it: Every connected MCP server dumps its full tool roster into context each message.

    line 60
  3. Distinctive:

    When the user explicitly asks for depth, thoroughness, or a full audit.

    line 80
  4. Very specific:

    If context feels heavy, suggest /context and trimming idle MCPs/skills.

    line 90
  5. Distinctive:

    If a CLAUDE.md / memory-file edit comes up, prefer the dense version.

    line 91
  6. Distinctive:

    Don't nag every message - set the defaults once, then just operate this way.

    line 93
  7. Distinctive:

    Never auto-edit the user's CLAUDE.md, memory files, or other curated config to "save tokens" - propose, show the diff, let them approve.

    line 97
  8. Distinctive:

    Never downgrade a client-facing deliverable to terser/English to save tokens.

    line 99
  9. Distinctive:

    Never skip verification or correctness steps as a "saving" - that is not what this is.

    line 100

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Frugal Mode

Expensive models (Fable 5, Opus 4.8) bill per token. The bill is not "how hard the task was" - it is how many tokens moved through the context window. Almost all waste comes from three places: thinking more than the task needs, reading whole files when a slice would do, and carrying dead weight in the context every single message.

This mode trims all three. The tactics below cost near-zero quality - they are about not paying for tokens that never helped. The core idea: all token management is context management. Everything loaded every message is the real bill; shrink that first, don't overthink, don't read whole files.

Persistence

ACTIVE EVERY RESPONSE once invoked, like caveman mode. Does not drift off after many turns. Off only when the user says "stop frugal" / "normal spending" / "frugal off". Composes with caveman (caveman = terse output, frugal = efficient operation).

The six tactics

Apply these by default. Each has a why - follow the reasoning, not a rigid rule.

1. Default LOW reasoning effort. Adaptive thinking overshoots - it tends to spend far more thinking tokens than the answer needs (that overspend is literally how the vendor makes money). High-intelligence models get most tasks right with little thinking. So default low; escalate to high/xhigh only for a genuinely hard problem - a subtle bug, real architecture, math, a tricky tradeoff. Measured delta is ~1.3-1.5x output tokens low vs xhigh for the same result. When you do escalate, say why in one line.

2. Search before you read. Never read a large file start to finish. Use Grep/Glob to locate the region, then Read with offset/limit, or sed the exact lines. On a 20k-line file this is a ~99% saving on that one call. Reading a whole file "to be safe" is the single most common silent token drain.

3. Filter, don't scan. For logs, CSVs, sheets, big JSON - query with a function or a targeted command instead of ingesting the raw text and eyeballing it. Let a grep/jq/SQL/script do the heavy lifting and return only the rows that matter.

4. Compress context files (propose, don't auto-edit). CLAUDE.md, memory files, and skill descriptions load on every message. Filler ("hello, thank you"), restated-obvious rules, and redundancy are pure recurring cost. When one is bloated, offer to compress it - same meaning, fewer words. Do NOT silently rewrite curated config; show the before/after and let the user approve.

5. Keep the context lean - audit it. Every connected MCP server dumps its full tool roster into context each message; idle skills add up too. Periodically suggest a /context check (interactive) to see what is eating the window, and disconnect servers not needed that day via /mcp. Keep a small default set of servers you actually use; reconnect others only for the task that needs them, then drop them again.

6. English to instruct, native language to deliver. English is more token-dense than most languages, so internal reasoning and prompting in English is cheaper. But this NEVER touches deliverables - user-facing copy in another language (carousels, emails, guides) stays in that language, always. Never trade product quality for tokens; that is the one place frugality stops.

When to relax

Frugality serves the work, not the other way around. Spend freely when the task genuinely needs it:

  • Hard debugging, architecture, or reasoning -> raise thinking effort. A wrong cheap answer costs more than the tokens saved.
  • Deliverable quality (client-facing work, polished copy) -> never compromise to save tokens.
  • When the user explicitly asks for depth, thoroughness, or a full audit.

The goal is zero wasted spend, not minimum spend. Cutting quality to save tokens is a false economy - flag it rather than do it silently.

Session-start checklist (when active)

At the start of a working session on a pricey model, quickly:

  1. Confirm reasoning effort is low unless the session is clearly a hard-reasoning task.
  2. If context feels heavy, suggest /context and trimming idle MCPs/skills.
  3. If a CLAUDE.md / memory-file edit comes up, prefer the dense version.

Don't nag every message - set the defaults once, then just operate this way.

Boundaries

  • Never auto-edit the user's CLAUDE.md, memory files, or other curated config to "save tokens" - propose, show the diff, let them approve.
  • Never downgrade a client-facing deliverable to terser/English to save tokens.
  • Never skip verification or correctness steps as a "saving" - that is not what this is.
  • Writing to files, commits, PRs: normal quality, unaffected by this mode.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.