🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Context Slimmer

by @sundevilatb

Audit and slim down always-loaded context files (AGENTS.md, TOOLS.md, USER.md, MEMORY.md, HEARTBEAT.md, SOUL.md, IDENTITY.md). Use when asked to reduce token usage, audit context files, optimize context window, or slim down workspace files. Measures current token cost and identifies what to move, remove, or compress.

Versionv1.0.0
Downloads1,922
Installs7
TERMINAL
clawhub install context-slimmer

πŸ“– About This Skill


name: context-slimmer description: Audit and slim down always-loaded context files (AGENTS.md, TOOLS.md, USER.md, MEMORY.md, HEARTBEAT.md, SOUL.md, IDENTITY.md). Use when asked to reduce token usage, audit context files, optimize context window, or slim down workspace files. Measures current token cost and identifies what to move, remove, or compress.

Context Slimmer

Audit workspace files that load into every message and reduce their token footprint.

Quick Start

# Measure current context cost
bash scripts/measure.sh

Full audit (outputs recommendations)

bash scripts/measure.sh --audit

Audit Process

For each always-loaded file, evaluate:

1. Move to skill β€” Content only needed for specific tasks (betting config, group chat rules, detailed protocols). Move to a skill or reference file that loads on demand. 2. Remove β€” Outdated info, dead features, completed one-time setup, duplicated content across files. 3. Compress β€” Verbose explanations that could be 1 sentence. If the agent already knows it, cut it.

Rules of Thumb

  • If a cron job handles it, remove it from HEARTBEAT.md
  • If it's in SOUL.md, don't repeat it in MEMORY.md or AGENTS.md
  • If it's in USER.md, don't repeat it in MEMORY.md
  • If the agent does it daily, it doesn't need instructions β€” just a trigger word
  • Prefer 1 sentence over 5 bullets saying the same thing
  • Target: each file should justify every line's token cost
  • Expected File Sizes (lean targets)

    | File | Target | |------|--------| | AGENTS.md | < 500 tokens | | TOOLS.md | < 500 tokens | | USER.md | < 700 tokens | | MEMORY.md | < 400 tokens | | HEARTBEAT.md | < 400 tokens | | SOUL.md | < 250 tokens | | IDENTITY.md | < 50 tokens | | Total | < 2,800 tokens |

    Output Format

    Report: current size, projected size, savings per file. Include specific recommendations grouped by move/remove/compress.

    πŸ’‘ Examples

    # Measure current context cost
    bash scripts/measure.sh

    Full audit (outputs recommendations)

    bash scripts/measure.sh --audit