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.

68

Quality

86%

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

88%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 content is a strong example of an instruction-plus-script skill: an executable command, a validated retry workflow with safe failure handling for a destructive overwrite, concrete compression rules, and worked examples. Its only real weakness is mild redundancy in the preservation rules and no reference-file split for the operational detail.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of concepts Claude already knows, just purpose, trigger, process, rules, patterns, and boundaries. Minor redundancy keeps it from anchor 5: the code/inline-code preservation rule is stated three times ('Preserve EXACTLY - Code blocks/Inline code', 'CRITICAL RULE: Anything inside ``` ... ``` must be copied EXACTLY', and 'Inline code (`...`) must be preserved EXACTLY'), and the out-of-tree backup location is repeated in Purpose and Boundaries. It is well above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready command ('From the directory containing this SKILL.md, run: python3 -m scripts <absolute_filepath>'), a concrete CLI behavior contract (detect, compress, validate, cherry-pick fix, retry up to 2, leave original untouched on failure), specific remove/preserve/compress word lists, and two worked before/after examples covering the common cases. All referenced files (scripts/__main__.py, scripts/compress.py) exist in the bundle.

5 / 5

Workflow Clarity

The 4-step Process has an explicit sequence with validation and feedback loops built in: the CLI 'validate output (no tokens)', 'cherry-pick fix with Claude', 'retry up to 2 times', and on persistent failure 'report error to user, leave original file untouched'. For a destructive operation (original file is overwritten) it also mandates a pre-write backup and skips FILE.original.md, matching anchor 5's explicit validation steps with error-recovery loops.

5 / 5

Progressive Disclosure

The body is well-organized into clear sections (Purpose, Trigger, Process, Compression Rules, Pattern, Boundaries) and correctly delegates implementation to the scripts/ bundle ('The compression scripts live in scripts/... search for scripts/__main__.py') without inlining any of the 47KB compress.py. It sits at anchor 4 rather than 5 because there is no references/ split — the rules, patterns, and boundaries (~70 lines of operational detail) are all inline in SKILL.md with no one-level-deep reference files for cases like mixed prose/code handling, and the Trigger section's guard-rail explanation runs a bit long.

4 / 5

Total

18

/

20

Passed

Description

78%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.

A strong, specific description in third person that clearly states what the skill does and how it is invoked, with concrete named artifacts. Its main gap is that the trigger guidance is limited to the '/caveman-compress' slash command, omitting natural-language 'use when' phrasing that would help Claude select it from conversational requests.

Suggestions

Add a 'Use when' clause covering conversational triggers, e.g. 'Use when the user asks to compress, shorten, or tokenize-reduce CLAUDE.md, memory files, or todo lists, or invokes /caveman-compress.'

Broaden trigger keywords with natural synonyms and file types ('shorten', '.md/.txt files', 'reduce token usage') to reach comprehensive trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Compress a memory file such as CLAUDE.md or a todo list into caveman format to save input tokens, keeping a readable backup' plus 'Sends the file's text to the configured model provider' — with only minor gaps (e.g., which file types are eligible). It names domain and multiple specific actions but falls short of the comprehensive anchor 5 ('Extract text and tables... fill forms, merge documents, convert pages'), and it is clearly above anchor 3, which covers only 1-2 actions.

4 / 5

Completeness

Both 'what' (compress memory files into caveman format, keep backup, sends text to provider) and 'when' are present, with 'Trigger: /caveman-compress' as explicit invocation guidance — so the missing-'Use when' cap at 3 does not apply. However, the 'when' covers only the slash command and omits conversational triggers ('when the user asks to compress a memory file'), fitting anchor 4's "'when' could be more explicit or specific" rather than anchor 5's concrete trigger phrases.

4 / 5

Trigger Term Quality

Includes natural terms users would say — 'memory file', 'CLAUDE.md', 'todo list', 'compress', 'input tokens' — plus an explicit 'Trigger: /caveman-compress' slash command. A few natural synonyms are missing ('shorten', '.md files', 'token usage'), matching anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinct — compressing memory/todo files into caveman-speak to save tokens — with named artifacts (CLAUDE.md, todo list) that no generic skill description would match, giving minimal conflict risk. This matches anchor 5's 'clear niche with distinct triggers'.

5 / 5

Total

17

/

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.