CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-compression

When agent sessions generate millions of tokens of conversation history, compression becomes mandatory. The naive approach is aggressive compression to minimize tokens per request.

Quality

56%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/context-compression/SKILL.md

The canonical home for this skill is context-compression in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-organized knowledge skill with genuine domain-specific content (tokens-per-task framing, structured summary template, probe-based evaluation), weakened by repetitive and padded sections, descriptive rather than instructive stretches, and a dangling internal reference to a file that does not exist.

Suggestions

Remove the verbatim repetition of the frontmatter description in the opening paragraph, merge the 'When to Use' and 'When to Use Each Approach' sections, and drop the 'Skill Metadata' block and duplicated 'Integration'/'References' lists to cut ~30 lines of padding.

Create the referenced 'Evaluation Framework Reference' file (or remove the reference) and move the probe-type table, evaluation dimensions, and compression-ratio comparison into it, keeping SKILL.md as a lean overview.

Convert descriptive sections (artifact trail problem, evaluation dimensions) into instructions — e.g., a concrete probe-evaluation procedure with scoring steps Claude can actually run, and how to wire an artifact index into agent scaffolding.

DimensionReasoningScore

Conciseness

The body is mostly efficient and skill-specific (probe tables, trigger strategies, compression-ratio data), but it opens by repeating the frontmatter description verbatim ("The naive approach is aggressive compression to minimize tokens per request"), restates "structure forces preservation" twice, duplicates trigger guidance across 'When to Use' and 'When to Use Each Approach', and carries padding such as the overlapping 'Integration'/'References' sections and a 'Skill Metadata' block. It could be tightened without losing substance, matching the 'mostly efficient but some unnecessary explanation' anchor rather than the lean or noticeably verbose ones.

3 / 5

Actionability

Concrete artifacts exist — the structured summary template, the 5-step 'Implementing Anchored Iterative Summarization' sequence, and the debug-session example — but much of the body is descriptive analysis rather than instruction: the artifact-trail problem, evaluation dimensions, and ratio tables describe findings without telling Claude how to act on them. As an instruction-only skill it has concrete guidance but it is incomplete (no probe implementation, no evaluation scoring procedure), fitting the 'some concrete guidance but incomplete' anchor; it does not reach 'mostly executable' because key execution details are missing.

3 / 5

Workflow Clarity

The three-phase workflow and the 5-step summarization procedure are clearly sequenced, and validation is addressed through dedicated sections ('Test compression quality with probe-based evaluation', guideline 8: 'Monitor re-fetching frequency as a compression quality signal'). Not a destructive/batch skill, so no cap applies. It sits below anchor 5 because no explicit validate→fix→retry feedback loop is woven into the workflow steps, but above anchor 3 because checkpoints are present rather than merely implicit.

4 / 5

Progressive Disclosure

Good section structure with clear headers, but no bundle files exist at all: the 'Internal reference: Evaluation Framework Reference - Detailed probe types and scoring rubrics' points to a nonexistent file, and content that clearly belongs in a separate reference (probe types, evaluation dimensions, compression-ratio tables) is inlined in a ~250-line SKILL.md. This matches 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' — not a 2 because the inline content is well-sectioned and navigable, not a monolithic wall.

3 / 5

Total

13

/

20

Passed

Description

36%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 reads as a problem statement and critique, not a capability description: it names a relevant domain but never says what the skill does and gives no explicit use-when guidance, so it would rarely be selected at the right moment. Voice is correctly third-person declarative, so no person-penalty applies.

Suggestions

Rewrite as a capability statement, e.g. 'Implements context compression for long agent sessions via anchored iterative summarization, structured file-tracking summaries, and probe-based quality evaluation...'

Add an explicit trigger clause: 'Use when sessions exceed context window limits, agents forget which files they modified, or when designing conversation summarization.'

Include natural trigger synonyms users would actually say — 'context window', 'compress context', 'summarize conversation history' — and differentiate from sibling skills like context-optimization.

DimensionReasoningScore

Specificity

The description names the domain ("agent sessions generate millions of tokens of conversation history, compression becomes mandatory") but lists zero concrete capabilities — it never says what the skill does, only stating a problem and critiquing a naive approach. This matches anchor 2 ('Names the domain but actions are minimal or generic') and falls below anchor 3, which requires 1-2 concrete actions; there are none. It stays above anchor 1 because the domain itself is specifically named rather than generic.

2 / 5

Completeness

The opening 'When agent sessions generate millions of tokens...' is a conditional scenario statement, not trigger guidance, and there is no 'Use when...' clause or equivalent — the rubric caps this at 3. Worse, the 'what' is only vaguely implied: the description never states a capability of the skill, only that 'compression becomes mandatory'. This fits anchor 2 ('only "when" is present without "what"', with a vague implied what) rather than anchor 3, which requires a clear 'what'.

2 / 5

Trigger Term Quality

Some genuinely natural terms are present — 'agent sessions', 'conversation history', 'compression', 'tokens' — which a user managing a long-running agent might plausibly say. But common variations are missing: 'context window', 'summarize', 'summarization', 'compress context', 'context limit'. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'), below anchor 4's 'good keyword coverage' and above anchor 2's generic-only bar.

3 / 5

Distinctiveness Conflict Risk

The niche (compressing agent conversation history) is fairly specific, but the skill's own body lists closely related siblings in the same collection — context-degradation, context-optimization, memory-systems, evaluation — with overlapping triggers like 'agents forget', 'summarization strategies', and 'evaluation frameworks'. The description does nothing to distinguish itself from these, matching anchor 3 ('somewhat specific but could still overlap with similar skills') rather than anchor 4's 'mostly distinct'.

3 / 5

Total

10

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/context-compression/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.