CtrlK
BlogDocsLog inGet started
Tessl Logo

context-compression

This skill should be used when long-running agent sessions need context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve decisions, files, risks, and next actions.

61

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/context-compression/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

The content is highly actionable with concrete templates, procedures, and worked examples, but it is verbose, keeps validation guidance out of the workflows, and under-uses its bundle (one reference, an orphaned script) relative to its monolithic length.

Suggestions

Deduplicate the tokens-per-task rationale and move the evaluation-framework / six-dimension scoring detail into the existing reference to slim the body.

Embed an explicit validate-against-source checkpoint inside the anchored-iterative and three-phase workflows, not only in Gotchas.

Reference scripts/compression_evaluator.py from the body (or move its API usage into a referenced guide) so the provided bundle is reachable.

DimensionReasoningScore

Conciseness

The body is well-organized but verbose — the tokens-per-task framing is restated across multiple sections and conceptual tradeoff prose could be tightened, leaning on knowledge Claude already has. Not a 1 because it avoids explaining truly basic concepts, and not a 3 because several passages do not earn every token.

2 / 3

Actionability

Provides a copy-paste structured-summary markdown template, a concrete 5-step anchored-iterative procedure, session-profile decision matrices, and worked before/after examples. Not a 2 because guidance is complete and specific rather than pseudocode or abstract; instruction-only absence of executable code is acceptable here since guidance is actionable.

3 / 3

Workflow Clarity

Sequences exist (three-phase workflow, 5-step iterative summarization) but validation checkpoints are not embedded in the workflows — 'validate compressed output against source material' appears only in Gotchas, and compression is information-destructive. Per the rubric, missing validation in destructive operations caps this at 2; not a 1 because steps are clearly sequenced.

2 / 3

Progressive Disclosure

One clearly-signaled one-level reference exists (./references/evaluation-framework.md, a real file with 'Read when:' guidance), but the ~270-line body is largely monolithic with six-dimension scoring, calibration tables, and detailed topics that could be split out. The bundled scripts/compression_evaluator.py is never referenced from the body. Not a 1 because sections are organized and a real reference is signaled; not a 3 because most detail is inline and an available bundle file is orphaned.

2 / 3

Total

9

/

12

Passed

Description

77%

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 and includes an explicit use-when trigger clause, but its trigger terms lean technical rather than matching natural user phrasing, and it does not disambiguate from closely related skills.

Suggestions

Add natural-language trigger variations a user would actually say, e.g. 'when an agent forgets which files it changed' or 'when a conversation gets too long to summarize'.

Add a brief disambiguating clause (e.g. 'not for general token-efficiency tactics — see context-optimization') to reduce conflict with adjacent skills.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — 'context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries' — matching the anchor for naming several specific actions. Not a 2 because the actions are concrete and enumerated rather than a vague domain label.

3 / 3

Completeness

The explicit 'This skill should be used when...' clause gives trigger guidance, while the listed capabilities answer what it does — both what and when are present. Not a 2 because the trigger clause is explicit, not merely implied.

3 / 3

Trigger Term Quality

Terms like 'context compression', 'summarization', and 'compaction' are relevant, but 'token-per-task optimization' and 'durable handoff summaries' are technical phrasing rather than what a user naturally says, and common variations ('summarize this conversation', 'agent forgot what it changed') are absent. Not a 3 because natural-user keyword coverage is thin.

2 / 3

Distinctiveness Conflict Risk

The compression niche is somewhat specific, but the description overlaps with adjacent skills (context-optimization, context-degradation, memory-systems) that the body itself disambiguates — a risk the description does not address. Not a 1 because the focus is narrower than 'helps with code and documents', and not a 3 because no disambiguating triggers are given.

2 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.