Caveman Compress

>.

You say
Install this skill Read the source first Free Written by JuliusBrussee · unverified publisher
Context cost
14.3k tokensestimated from the bundle, loaded when it triggers
Bundle
10 files · 57.2 kB7 scripts among them — read before you run
Licence
MITfree to use
Last change
no release on file
Servers it uses
Noneruns standalone

What it does

Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file"

Installed, it changes the agent in these ways.

What this skill changes about the agent is not written down here yet. The listing was collected from its source, and the description is in its own SKILL.md.

Guardrail

Constrains what the agent is allowed to do.

productivity

The skill itself

This is the whole product. A skill is instructions the model reads, so there is nothing behind the listing you cannot see first — the front matter loads with every session, and the body below it loads when the skill triggers.

SKILL.md4.9 kB · 112 lines
--- name: caveman-compress description: > Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file" ---
10# Caveman Compress
11
12## Purpose
13
14Compress natural language files (CLAUDE.md, todos, preferences) into caveman-speak to reduce input tokens. Compressed version overwrites original. Human-readable backup saved as <filename>.original.md, but NOT beside the source file — it lives in an out-of-tree data dir ($XDG_DATA_HOME/caveman-compress/backups/<parent-dir-name>/, or %LOCALAPPDATA%\caveman-compress\backups\<parent-dir-name>\ on Windows) so skill auto-loaders don't re-ingest it as a live file.
15
16## Trigger
17
18/caveman-compress <filepath> or when user asks to compress a memory file.
19
20## Process
21
221. The compression scripts live in scripts/ (adjacent to this SKILL.md). If the path is not immediately available, search for scripts/__main__.py next to this SKILL.md.
23
242. From the directory containing this SKILL.md, run:
25
26python3 -m scripts <absolute_filepath>
27
283. The CLI will:
29- detect file type (no tokens)
30- call Claude to compress
31- validate output (no tokens)
32- if errors: cherry-pick fix with Claude (targeted fixes only, no recompression)
33- retry up to 2 times
34- if still failing after 2 retries: report error to user, leave original file untouched
35
364. Return result to user
37
38## Compression Rules
39
40### Remove
41- Articles: a, an, the
42- Filler: just, really, basically, actually, simply, essentially, generally
43- Pleasantries: "sure", "certainly", "of course", "happy to", "I'd recommend"
44- Hedging: "it might be worth", "you could consider", "it would be good to"
45- Redundant phrasing: "in order to" → "to", "make sure to" → "ensure", "the reason is because" → "because"
46- Connective fluff: "however", "furthermore", "additionally", "in addition"
47
48### Preserve EXACTLY (never modify)
49- Code blocks (fenced ``` and indented)
50- Inline code (backtick content)
51- URLs and links (full URLs, markdown links)
52- File paths (/src/components/..., ./config.yaml)
53- Commands (npm install, git commit, docker build)
54- Technical terms (library names, API names, protocols, algorithms)
55- Proper nouns (project names, people, companies)
56- Dates, version numbers, numeric values
57- Environment variables ($HOME, NODE_ENV)
58
59### Preserve Structure
60- All markdown headings (keep exact heading text, compress body below)
61- Bullet point hierarchy (keep nesting level)
62- Numbered lists (keep numbering)
63- Tables (compress cell text, keep structure)
64- Frontmatter/YAML headers in markdown files
65
66### Compress
67- Use short synonyms: "big" not "extensive", "fix" not "implement a solution for", "use" not "utilize"
68- Fragments OK: "Run tests before commit" not "You should always run tests before committing"
69- Drop "you should", "make sure to", "remember to" — just state the action
70- Merge redundant bullets that say the same thing differently
71- Keep one example where multiple examples show the same pattern
72
73CRITICAL RULE:
74Anything inside `` ... `` must be copied EXACTLY.
75Do not:
76- remove comments
77- remove spacing
78- reorder lines
79- shorten commands
80- simplify anything
81
82Inline code (...) must be preserved EXACTLY.
83Do not modify anything inside backticks.
84
85If file contains code blocks:
86- Treat code blocks as read-only regions
87- Only compress text outside them
88- Do not merge sections around code
89
90## Pattern
91
92Original:
93> You should always make sure to run the test suite before pushing any changes to the main branch. This is important because it helps catch bugs early and prevents broken builds from being deployed to production.
94
95Compressed:
96> Run tests before push to main. Catch bugs early, prevent broken prod deploys.
97
98Original:
99> The application uses a microservices architecture with the following components. The API gateway handles all incoming requests and routes them to the appropriate service. The authentication service is responsible for managing user sessions and JWT tokens.
100
101Compressed:
102> Microservices architecture. API gateway route all requests to services. Auth service manage user sessions + JWT tokens.
103
104## Boundaries
105
106- ONLY compress natural language files (.md, .txt, .typ, .typst, .tex, extensionless)
107- NEVER modify: .py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
108- If file has mixed content (prose + code), compress ONLY the prose sections
109- If unsure whether something is code or prose, leave it unchanged
110- Original file is backed up as FILE.original.md before overwriting — in the out-of-tree backup data dir (see Purpose), not beside the source file
111- Never compress FILE.original.md (skip it)
112
In the file
SKILL.md720 words
Files10
LicenceMIT
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈100
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
14,200
on trigger
The instruction body and 9 supporting files, read only when the skill fires.
7.1%
of a 200k window
Ten skills this size would take about 72% of the window before you open a file.
050k100k150k200k context window

14.3k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Heavy. Teams tend to install this one per project rather than globally, and load it only when the job comes up.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

Adoption
Installsnone yet
Ratingno reviews yet

The procedure it runs

The procedure has not been published here. It is in the skill’s own SKILL.md, which its author has not sent to the marketplace yet.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

It writes no files and reaches no network. All it changes is how the model reasons and writes.

What it asks for
Writes filesno
Network accessno

Read from the allowed-tools line of this skill’s own SKILL.md. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

10 files, 57.2 kB on disk. Mostly text — the instructions the model reads — with 7 scripts in it that your client would run only if the instructions tell it to.

  • README.md5.5 kB
  • SECURITY.md1.7 kB
  • SKILL.md4.9 kB
  • scripts/__init__.py0.2 kB
  • scripts/__main__.py0.1 kB
  • scripts/benchmark.py2.5 kB
  • scripts/cli.py2.1 kB
  • scripts/compress.py20.9 kB
  • scripts/detect.py4.8 kB
  • scripts/validate.py14.5 kB
What is not in it

A skill installs nothing and depends on nothing: it is a folder your client reads. This one carries 7 scripts beside the text, so the bundle is 10 files you can review in full before installing. The MIT licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

# Caveman Compress · 14.3k tokens when loaded npx mcprush@latest skill add juliusbrussee/caveman-compress

Writes to .claude/skills/caveman-compress/ in the current project. Add --global to put it in your home directory instead, for every project.

Which clients pick it up on their own

A skill is a folder of text. A client with a skills folder reads it without being told; everywhere else the same text works, it is just handed to the model rather than found.

Claude Code.claude/skills/
Claude Desktop
ChatGPT
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok.grok/skills/
Zed.agents/skills/
Windsurf.windsurf/skills/
Agent SDK.claude/skills/
HTTP / API
This release
Versionnot versioned
Publishedno release date on file
PriceFree
Referencejuliusbrussee/caveman-compress

Versions

Its author publishes no version number, so there is nothing here to pin to: what you install is the folder as it stands today. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v
  • No earlier releases have been published to the marketplace.
Pinning

Nothing to pin to: this skill carries no version number of its own. What you install is what the folder holds on the day you install it.

Reviews

no reviews yet · no installs yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Who can post

Only accounts that have had the skill installed for fourteen days, so a review is written after living with it rather than after reading it. Publishers may reply once.

Who wrote it

JU
JuliusBrussee

Publishes on mcprush.

0 servers listed3 skills listednot claimed
Profile
More from JuliusBrusseeCACaveman Commit>CACaveman Review>
Publisher
Servers0