CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

caveman-compress

Compress a memory file such as CLAUDE.md or a todo list into caveman format to save input tokens, keeping a readable backup. Sends the file's text to the configured model provider. Trigger: /caveman-compress.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is caveman-compress in JuliusBrussee/caveman

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers fully executable guidance with an exemplary validation/retry workflow and honest data-privacy boundaries, and its bundle references are accurate. Its one real weakness is token efficiency: the detailed Compression Rules and Pattern sections largely duplicate the prompt already embedded in scripts/compress.py and could be condensed.

Suggestions

Condense the Compression Rules and Pattern sections to a short summary of caveman style (or move them to a references/ file), since scripts/compress.py already embeds the full rules in its model prompt and Claude never applies them manually.

State the code-block and inline-code preservation rule once instead of three times (Preserve EXACTLY list, CRITICAL RULE block, and the trailing bullet list).

Trim the redundant path-discovery instruction in Process step 1 now that step 2 already gives the exact command from the SKILL.md directory.

DimensionReasoningScore

Conciseness

The Purpose, Trigger, Process, and Boundaries sections are lean and assume Claude's competence, but roughly half the body ("Compression Rules" and "Pattern", ~55 of 106 lines) restates rules that scripts/compress.py already embeds in its own model prompt ("Preserve ALL URLs exactly", "Preserve ALL headings exactly"), and the code-block/inline-code preservation rule is stated three separate times. It is not 2 because nothing explains general concepts Claude already knows; it is not 4 because the duplication is substantial rather than minor and could be tightened to a short summary.

3 / 5

Actionability

The exact executable command is given ("python3 -m scripts <absolute_filepath>") along with a fallback for locating scripts/__main__.py, concrete before/after compression examples, and explicit extension allow/deny lists. This is copy-paste ready guidance covering the common cases, matching the top anchor rather than 4's "minor gaps".

5 / 5

Workflow Clarity

The Process section gives a clear sequence with explicit validation and a feedback loop ("validate output (no tokens)", "cherry-pick fix with Claude", "retry up to 2 times", "if still failing ... leave original file untouched"), and the destructive overwrite is guarded by an out-of-tree backup. Since validation and error-recovery checkpoints are explicitly present, the destructive-operation cap at 3 does not apply and the content matches the top anchor.

5 / 5

Progressive Disclosure

The body is organized into clear sections and its references to the bundle are real and one level deep (scripts/__main__.py and scripts/compress.py both exist in scripts/), with no nested reference chains. It is not 5 because the ~55-line inline Compression Rules section duplicates script-embedded behavior that could live in a reference file or be summarized, leaving a minor organization gap rather than a fully appropriate split.

4 / 5

Total

17

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, honest about the data flow to the model provider, and clearly scoped to memory-file compression with an explicit slash-command trigger. Its main weaknesses are a trigger clause limited to the slash command with no natural-language "use when" phrasing, and keyword coverage that misses common synonyms a user might say.

Suggestions

Add a natural-language trigger clause, e.g. "Use when the user asks to compress, shorten, or token-shrink CLAUDE.md, AGENTS.md, or another memory/todo file".

Include a few more natural synonyms and file names users would say ("shrink", "reduce context", "AGENTS.md", "README") to broaden trigger coverage.

Optionally state the accepted file types (e.g. .md/.txt) so the description matches the skill's actual boundaries.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Compress a memory file such as CLAUDE.md or a todo list into caveman format", "keeping a readable backup", "Sends the file's text to the configured model provider" — with named targets, matching the several-specific-actions anchor. It falls short of 5 because coverage has gaps (no mention of validation, the refusal of sensitive files, or which file types qualify).

4 / 5

Completeness

The "what" is clearly stated (compress memory files to caveman format with a readable backup to save tokens), and the "when" is addressed via "Trigger: /caveman-compress", which counts as explicit trigger guidance so the missing-Use-when cap at 3 does not apply. It stays at 4 rather than 5 because the when-clause names only the slash command and omits natural-language trigger conditions (e.g. "use when the user asks to compress or shorten a memory file").

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "compress", "memory file", "CLAUDE.md", "todo list", "save input tokens", plus the explicit "/caveman-compress" trigger. It is not 5 because common variations like "shorten", "shrink", "reduce context", or other memory-file names (e.g. AGENTS.md, README) are missing.

4 / 5

Distinctiveness Conflict Risk

"Caveman format", "input tokens", and "memory file" carve out a clear niche that is hard to confuse with document or data skills. Minor overlap risk remains because a bare request to "compress a file" could plausibly mean zip/gzip, keeping it below the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

JuliusBrussee/caveman

Path

plugins/caveman/skills/caveman-compress/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.