caveman-compress

Compresses natural language memory files into terse caveman format to reduce input tokens.

1|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/CliffVale/opencode-free-setup --skill caveman-compress-cliffvale
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/CliffVale/opencode-free-setup/tree/main/skills/caveman-compress
Command: npx skills add https://github.com/CliffVale/opencode-free-setup --skill caveman-compress-cliffvale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long memory files like CLAUDE.md, todo lists, and preference notes consume large amounts of input tokens every time they are loaded into an AI context window. This Skill rewrites them in a terse caveman style that preserves all technical substance while cutting token usage. ## Core Features & Use Cases - Token-reducing compression: Removes articles, filler words, hedging, and redundant phrasing while keeping meaning intact. - Strict preservation rules: Code blocks, inline code, URLs, file paths, commands, technical terms, and markdown structure are never modified. - Safe overwrite with backup: The compressed version overwrites the original file, and a human-readable backup is saved as FILE.original.md. - Validated pipeline: A CLI script detects file type, compresses via Claude, validates output, applies targeted fixes, and retries up to 2 times before reporting failure. - Use Case: Your CLAUDE.md has grown to several thousand tokens of verbose instructions. Run the compression to shrink it dramatically while keeping every command, path, and rule intact. ## Quick Start Ask the AI to compress your memory file by saying: compress memory file /path/to/CLAUDE.md with caveman-compress.

Frequently Asked Questions about caveman-compress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compress a CLAUDE.md file to save tokens?▼

Run the caveman-compress skill with the file path, either via the /caveman-compress FILEPATH trigger or by asking to compress a memory file. The script rewrites prose into terse fragments while keeping all code, URLs, and commands unchanged.

How to reduce token usage from AI memory files?▼

Convert verbose natural language instructions into caveman-style fragments by removing articles, filler words, hedging, and redundant phrasing. This skill automates that compression and validates the output before overwriting the file.

Does compressing memory files affect code blocks or commands?▼

No. Code blocks, inline code, URLs, file paths, shell commands, technical terms, dates, and version numbers are treated as read-only and copied exactly. Only the surrounding prose is compressed.

What file types can be compressed with caveman-compress?▼

Only natural language files are supported: .md, .txt, .typ, .typst, .tex, and extensionless files. Code and config files like .py, .js, .json, .yaml, .toml, .sql, and .sh are never modified.

What happens if compression fails or produces errors?▼

The CLI validates the output and applies targeted fixes, retrying up to 2 times. If it still fails, it reports the error and leaves the original file untouched. A backup is always saved as FILE.original.md before any overwrite.