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.

60

Quality

75%

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 ./skills/context-compression/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, genuinely informative skill body with concrete templates, step-by-step procedures, and decision tables covering a complex domain. Its main weaknesses are redundancy across sections (Guidelines, Integration, and References restate earlier content) and a missed progressive-disclosure link to the bundled evaluator script.

Suggestions

Deduplicate restated content: fold the Guidelines section into the Detailed Topics it summarizes and merge the Integration and References sibling-skill listings into one list with 'Read when' guidance.

Add a reference to scripts/compression_evaluator.py with 'Read when' guidance so the bundled evaluator script is discoverable from SKILL.md.

Insert an explicit validation checkpoint into the five-step anchored summarization procedure (e.g., validate the merged summary against source material or run a probe set before discarding the original context).

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and delivers largely non-obvious domain guidance, but includes notable redundancy: the Guidelines section restates Detailed Topics points, approach-selection guidance appears in both 'Core Concepts' and 'Select the Right Approach for the Session Profile', and the Integration and References sections both enumerate sibling skills. Mostly efficient but could be tightened — anchor 3, not 2 since no section is pure padding or known-concept explanation.

3 / 5

Actionability

Provides a copy-paste-ready structured summary template, a five-step anchored iterative summarization procedure, decision tables (trigger strategies, compression ratios, probe types), and explicit selection criteria per session profile. Falls short of anchor 5 because some guidance remains abstract — e.g., 'Implement a separate artifact index or explicit file-state tracking in agent scaffolding' offers no concrete example of what that looks like.

4 / 5

Workflow Clarity

The three-phase compression workflow and step-by-step anchored summarization are clearly sequenced, and validation guidance exists ('Always validate compressed output against source material before discarding originals', probe-based evaluation). Anchor 4 rather than 5 because validation is described as a separate practice rather than embedded as explicit checkpoints inside the step sequences (e.g., the five-step anchored summarization procedure has no validate step).

4 / 5

Progressive Disclosure

Sections are well organized and the one reference file (./references/evaluation-framework.md) is clearly signaled with 'Read when' guidance, one level deep. Not anchor 5 because the bundle's scripts/compression_evaluator.py (a substantial script in the skill directory) is never referenced anywhere in the body — a navigation gap; above anchor 3 since what is referenced is well signaled and content placement is generally appropriate.

4 / 5

Total

15

/

20

Passed

Description

71%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 description with explicit trigger conditions and good natural-language keyword coverage including synonyms. Its main weaknesses are an implicit 'what' (capabilities stated as needs, not actions) and secondary trigger terms that overlap with adjacent skills without any boundary disambiguation.

Suggestions

State the 'what' as explicit actions (e.g., 'Implements structured summarization, compression trigger strategies, and probe-based evaluation for...') rather than only as session needs.

Trim or reword secondary triggers like "token-per-task optimization" that overlap with the context-optimization skill, or add a brief scoping clause distinguishing this skill from adjacent ones.

DimensionReasoningScore

Specificity

Lists multiple concrete capability areas — "context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve decisions, files, risks, and next actions" — with only minor coverage gaps. Falls short of anchor 5 because capabilities are framed as session needs ('should be used when ... need X') rather than explicit actions the skill performs.

4 / 5

Completeness

The 'when' is explicit and concrete ("when long-running agent sessions need context compression, structured summarization, compaction..."), but the 'what' is only implied through the needs list rather than stated as what the skill does. That matches anchor 4 — both present, one less explicit — rather than anchor 5's fully explicit what-and-when.

4 / 5

Trigger Term Quality

Good keyword coverage with natural synonyms users would say: "context compression", "compaction", "structured summarization", "durable handoff summaries", "long-running agent sessions". Not anchor 5 because common variations like "context window limits" or "session summary" are missing; clearly above anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The core niche (compression/compaction of long-running sessions) is fairly distinct, but secondary triggers "token-per-task optimization" and "durable handoff summaries" overlap with sibling skills the body itself disclaims (context-optimization, memory-systems), and the description carries no boundary guidance. Somewhat specific yet overlapping — anchor 3, not 4, because two of five triggers risk firing the wrong skill.

3 / 5

Total

15

/

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