caveman-compress · Skill Details

Mechanism

When It Triggers · How It Works · What It Produces

Breaks down how the skill works and what it produces, so you can quickly judge whether it fits your scenario and value.

Trigger

User types /caveman-compress <filepath>.
User says "compress memory file" or similar natural language requests.

Mechanism

Agent locates scripts/__main__.py in the skill directory and runs python3 -m scripts <absolute_filepath>.
The Python CLI pipeline: detect file type → call Claude API for compression → validate output → retry up to 2 times → overwrite original.
Compression rules: remove articles/filler/pleasantries/hedging, use short synonyms; preserve code blocks, inline code, URLs, file paths, technical terms, table structures, YAML frontmatter entirely unchanged.
Original file backed up as <filename>.original.md; backup files are never compressed.
Only processes natural language files (.md/.txt/.typ/.typst/.tex and extensionless prose); never modifies .py/.js/.ts/.json etc.

Result

Original file overwritten with caveman-compressed version, preserving all structure and technical content.
Original backed up as FILE.original.md for human reading.
~46% average input token reduction, benefiting every subsequent session.

Use Cases

Two Typical Use Cases

Scenario 01

Compressing Claude Code project memory files

A Claude Code developer has a large `CLAUDE.md` project memory file that consumes significant input tokens on every session load. Running `/caveman-compress CLAUDE.md` compresses it into caveman format, removing filler and redundant narration while preserving all code examples, commands, and paths. A backup is saved as `CLAUDE.md.original.md`. Every subsequent session loads this file with ~46% fewer input tokens.

Scenario 02

Compressing todo lists and preference files

A developer maintains todo lists, coding preference configs, and other Markdown memory files. The natural language descriptions in these files consume many tokens with low information density. Using `/caveman-compress` batch-compresses these files — the agent identifies and compresses only prose sections, preserving all code blocks, YAML frontmatter, table structures, and other technical content unchanged, ensuring structural integrity and readability after compression.

Skill Relationships

Which Skills I Use · Which Skills Use Me

Dependency relationships read as "the upper tier points to the lower tier." The current Skill sits in the middle tier — above are Skills that depend on it, below are Skills it depends on.

Tier 1 · These Skills Use Me

caveman-helpCLI Manual

Tier 2 · Current Skill

caveman-compressWorkflow

Tier 3 · I Use These Skills

No explicit dependency on other Skills

Full Relationship Graph

Browse this skill's relationships within its skillset. Click a node to switch the side panel; use the search box to jump to any skill.

Skill File

SKILL.md

Open in GitHub ↗

SKILL.mdLoading from GitHub…

Skill Composition

Open in GitHub ↗

SKILL.md10.0%
scripts70.0%
other20.0%

▸skills/caveman-compress/
▸caveman-compress
- ·README.md
- ·SECURITY.md
- ·SKILL.md
- ▸scripts
  - ·__init__.py
  - ·__main__.py
  - ·benchmark.py
  - ·cli.py
  - ·compress.py
  - ·detect.py
  - ·validate.py

Per the Agent Skills spec, SKILL.md is the only required file. The colored bars classify the rest into the three spec-aligned optional directories (scripts / references / assets) and an 'other' bucket. The full directory tree is below.

Related in Skillset

You May Also Need These Skills

cavecrew

The cavecrew skill provides a delegation decision guide for three caveman-style subagent presets: `cavecrew-investigator` (locate code), `cavecrew-builder` (surgical 1-2 file edits), and `cavecrew-reviewer` (diff review). Subagent output is caveman-compressed, returning tool results ~60% smaller into main context than standard subagents. Key output: ~60% context token savings per delegation, letting the main thread accomplish more before context exhaustion.

Workflow

caveman

The caveman skill is the core of the Caveman skillset. It saves ~65% output tokens by making the AI coding agent reply in ultra-terse "caveman speak". Supports 6 intensity levels (lite/full/ultra/wenyan), strips filler/pleasantries/hedging while preserving code, technical terms, and error messages verbatim. Key output: dramatically reduced output token consumption per session, faster code reading, lower API costs.

Workflow

caveman-commit

The caveman-commit skill generates ultra-compressed Git commit messages following Conventional Commits format. Subject line ≤50 chars, body only when "why" isn't obvious. Automatically strips "This commit does X", "I", "we" filler and AI attribution. Key output: a terse but information-complete commit message code block ready to paste into `git commit`. The agent only generates the message — it does not run git commit, stage files, or amend commits.

Workflow

caveman-help

The caveman-help skill provides a quick-reference card for all caveman modes, skills, and commands. It is one-shot display only — it does not change any mode or persist anything. When triggered by `/caveman-help`, "caveman help", or "what caveman commands", the agent outputs a caveman-style reference table covering all modes (lite/full/ultra/wenyan), skills (commit/review/compress/help), and configuration tips. Helps users quickly grasp the full caveman ecosystem.

CLI Manual