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.

65

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

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 is a tight, executable runbook: exact command, explicit validation, bounded retries, and safe failure for a destructive overwrite, plus concrete compression rules and worked examples. The main weaknesses are the triple-stated code-block preservation rule and the inlined rule/example detail that could live one level deep.

DimensionReasoningScore

Conciseness

Mostly efficient with purposeful sections, but the 'CRITICAL RULE' block re-states the code-block preservation rules already given under 'Preserve EXACTLY', and the backup location is stated twice (Purpose and Boundaries). Not 4: the duplication is more than a minor trim (~16 redundant lines); not 2: the rest of the body is dense and earns its tokens.

3 / 5

Actionability

Fully executable guidance: the exact command ('python3 -m scripts <absolute_filepath>'), explicit failure handling (retry up to 2 times, leave original untouched), concrete extension allow/deny lists, and two worked before/after examples covering the common cases. Not 4: no meaningful gaps — everything needed to run the skill is copy-paste ready.

5 / 5

Workflow Clarity

Numbered process with explicit validation ('validate output (no tokens)'), a bounded feedback loop ('cherry-pick fix ... retry up to 2 times'), and safe failure ('report error to user, leave original file untouched') — with a backup made before the destructive overwrite. The destructive-operation cap does not apply since validation and error recovery are present. Not 4: no validation gaps identified.

5 / 5

Progressive Disclosure

Well-organized single-file structure with clean, verified one-level references into the scripts bundle ('scripts/__main__.py', 'scripts/compress.py' both exist; no references/ or assets/ dirs). Not 5: at ~106 lines (over the 50-line simple-skill threshold), the detailed Compression Rules and Pattern sections could be split one level deep to keep SKILL.md a leaner overview; not 3: structure is good and references are clearly signaled.

4 / 5

Total

17

/

20

Passed

Description

73%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 clearly and concretely states what the skill does using natural domain terms, and includes an explicit trigger, though the trigger is only the slash command rather than natural 'Use when ...' phrases. It occupies a distinct niche with minimal conflict risk.

Suggestions

Lift specificity by enumerating the concrete sub-actions in the description, e.g. 'Compresses CLAUDE.md, todo lists, and other natural-language files into caveman-speak, backs up the original to an out-of-tree data dir, and skips code-heavy or secret-looking files.'

Add a natural-language trigger clause alongside the slash command, e.g. 'Use when the user asks to compress, shrink, or token-reduce CLAUDE.md, memory files, or todo lists.'

DimensionReasoningScore

Specificity

Names the domain ('memory file such as CLAUDE.md or a todo list') and 1-2 concrete actions ('Compress ... into caveman format', 'keeping a readable backup'), but coverage is not comprehensive — one core capability rather than several listed actions. Not 4: it does not list several specific actions; not 2: the actions given are concrete, not generic.

3 / 5

Completeness

The 'what' is clear and concrete, and a 'when' is explicitly present via 'Trigger: /caveman-compress', but only as a slash command rather than a natural-language 'Use when ...' clause, so it could be more explicit. Not 5: no concrete natural trigger phrases; not 3: trigger guidance is explicit, not merely weakly implied.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('Compress', 'memory file', 'CLAUDE.md', 'todo list', 'save input tokens'), but common synonyms ('shrink', 'reduce tokens') and file extensions (.md) are missing, and the only explicit trigger is the slash command. Not 5: coverage is not comprehensive; not 3: several relevant natural terms are present, matching 'a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

Caveman-format compression of memory files (CLAUDE.md, todo lists) is a clear niche with a distinct trigger and minimal conflict risk with other skills. Not 4: no meaningful overlap with closely related skills — the object ('memory file such as CLAUDE.md') disambiguates the otherwise ambiguous word 'compress'.

5 / 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

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.