CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-compactor

Automatic context summarization for long-running sessions. Use when context is approaching limits, summarizing completed work, preserving critical information, or managing token budgets.

Quality

73%

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 ./.claude/skills/context-compactor/SKILL.md

The canonical home for this skill is context-compactor in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 reasonable overview with a working Quick Start that matches the bundled scripts, but it underperforms on discipline: a padded ASCII diagram, content duplicated from the reference file, a broken reference to the missing TOKEN-BUDGETS.md, and a validation step that names a checkpoint without operationalizing it.

Suggestions

Fix or remove the reference to references/TOKEN-BUDGETS.md, which does not exist in the bundle.

Replace the 23-line ASCII box with a compact MUST PRESERVE / CAN SUMMARIZE / CAN DISCARD bullet list, and defer the detailed hierarchy and token-budget table to references/COMPACTION-STRATEGY.md instead of duplicating them inline.

Operationalize the Validate step in the Compaction Process — e.g. 'Check compacted.compacted_tokens < target and confirm preserved_count covers all score >= 0.7 messages; if not, lower target_reduction and re-compact' — to add a real feedback loop.

DimensionReasoningScore

Conciseness

Mostly efficient with no explanations of concepts Claude already knows, but the 23-line ASCII box diagram restating the preservation hierarchy as a compact bullet list, and the Token Budgets table duplicated verbatim in references/COMPACTION-STRATEGY.md, are padding that could be tightened. Not 4 because the duplication and the box-art represent more than minor over-explanation.

3 / 5

Actionability

The Quick Start code is executable and its API (should_compact(context, limit=100000), compact(context)) matches scripts/compactor.py, and all four listed scripts exist. Minor gaps keep it from 5: the example doesn't show how to consume the result (compacted.messages / reduction_percentage), and 'from scripts.compactor import' assumes a package layout with no __init__.py present.

4 / 5

Workflow Clarity

The Compaction Process lists a clear five-step sequence including a 'Validate' step, but validation is vague ('Ensure compacted context is coherent') with no method and no feedback loop for what to do if coherence fails. This matches the 3 anchor 'sequence present but checkpoints missing or implicit' rather than 4's 'most checkpoints present with minor gaps'.

3 / 5

Progressive Disclosure

Structure is good (overview sections plus one-level-deep References and Scripts listings), but scoring against the actual bundle reveals defects: references/TOKEN-BUDGETS.md is referenced yet does not exist (broken navigation), and the body inlines the preservation hierarchy and token-budget table that duplicate references/COMPACTION-STRATEGY.md — content that should live in the separate file. This fits the 3 anchor rather than 4's 'minor organization gaps'.

3 / 5

Total

13

/

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 well-formed description with an explicit and specific 'Use when...' clause covering multiple natural triggers, in proper third-person voice. Its main weakness is that the 'what' side names only one action, leaving the skill's concrete capabilities (scoring, compacting, discarding) unstated.

Suggestions

Expand the 'what' clause with 1-2 more concrete actions, e.g. 'Scores message importance, compacts context, and discards stale tool output while preserving critical information.'

Add natural trigger synonyms such as 'context window', 'compact the conversation', or 'token limit' to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Automatic context summarization for long-running sessions') and one core action (summarization), but does not enumerate the concrete operations the skill performs (scoring message importance, compacting, discarding stale content). It matches 'names domain and 1-2 concrete actions, but not comprehensive' rather than 4, which requires several specific actions listed.

3 / 5

Completeness

It explicitly answers both: what ('Automatic context summarization for long-running sessions') and when ('Use when context is approaching limits, summarizing completed work, preserving critical information, or managing token budgets') with four concrete trigger phrases. The 'when' is explicit and specific, matching the 5 anchor rather than 4 where the trigger guidance could be more explicit.

5 / 5

Trigger Term Quality

Triggers like 'context is approaching limits', 'summarizing completed work', and 'managing token budgets' are phrases a user would naturally say. It falls short of 5 because common synonyms such as 'context window', 'compact the conversation', or 'running out of context' are missing.

4 / 5

Distinctiveness Conflict Risk

The context-limit/token-budget niche is mostly distinct from other skills, but 'summarizing completed work' and 'preserving critical information' could plausibly trigger a general memory or summarization skill, giving minor overlap risk consistent with the 4 anchor rather than 5's 'minimal conflict risk'.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/context-compactor/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.