Maximize context window efficiency, reduce latency, and prevent lost-in-middle issues through strategic masking and compaction. Use when token budgets are tight, tool outputs flood the context, conversations drift from intent, or latency spikes from cache misses.
47
51%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/common/common-context-optimization/SKILL.mdQuality
Discovery
75%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 has strong completeness with an explicit 'Use when' clause and occupies a distinct niche, making it unlikely to conflict with other skills. However, the specificity of concrete actions could be improved—terms like 'maximize efficiency' are more aspirational than actionable—and the trigger terms lean heavily technical, potentially missing more natural user phrasings.
Suggestions
Replace goal-oriented phrases like 'maximize context window efficiency' with concrete actions such as 'masks irrelevant tool outputs, compacts conversation history, prunes stale context segments.'
Add more natural trigger terms users might actually say, such as 'running out of context,' 'too many tokens,' 'context too long,' or 'conversation too large.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names a domain (context window management) and mentions some actions like 'strategic masking and compaction,' but the specific concrete actions are somewhat vague—'maximize efficiency' and 'reduce latency' are more like goals than discrete actions. It doesn't list specific step-by-step operations. | 2 / 3 |
Completeness | The description clearly answers both 'what' (maximize context window efficiency, reduce latency, prevent lost-in-middle issues through masking and compaction) and 'when' (token budgets are tight, tool outputs flood context, conversations drift, latency spikes from cache misses) with an explicit 'Use when' clause. | 3 / 3 |
Trigger Term Quality | Includes some relevant technical terms like 'token budgets,' 'context window,' 'latency,' 'cache misses,' and 'tool outputs,' but these are fairly technical and may not match natural user language. Users might say things like 'running out of context' or 'too many tokens' rather than 'lost-in-middle issues' or 'compaction.' | 2 / 3 |
Distinctiveness Conflict Risk | This skill occupies a very specific niche around context window optimization, masking, and compaction. The triggers are distinct and unlikely to conflict with other skills—terms like 'token budgets,' 'lost-in-middle,' and 'cache misses' are highly specific to this domain. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill identifies a legitimate and useful optimization domain with a reasonable organizational structure, but falls short on execution. Critical implementation details are deferred to non-existent reference files, leaving the skill without concrete examples or executable guidance. The abstract descriptions of masking and compaction processes need concrete before/after examples to be actionable.
Suggestions
Add concrete before/after examples showing what a masked observation looks like (e.g., raw JSON tool output → semantic summary replacement)
Include a concrete example of compacted state format showing what 'Keep' vs 'Drop' looks like in practice
Either provide the referenced bundle files (masking.md, compaction.md, implementation.md) or inline the essential content they would contain
Add a validation step after masking/compaction to verify critical information was preserved (e.g., 'Verify compacted state still contains: original user goal, current error state, pending decisions')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but includes some unnecessary framing like 'Problem/Solution' labels and the priority header. The 'Problem' statements explain things Claude already understands (e.g., 'Large tool outputs flood context and degrade reasoning'). Could be tightened by removing these explanatory frames. | 2 / 3 |
Actionability | No executable code, no concrete examples of masked output, no example of a compacted state format, no specific commands. The steps are described abstractly ('Mask by rewriting history to replace raw data with summary placeholder') without showing what that actually looks like. Key details are deferred to reference files that don't exist in the bundle. | 1 / 3 |
Workflow Clarity | Steps are numbered and sequenced for masking and compaction, with clear triggers (50 lines/1KB, every 10 turns/8k tokens). However, there are no validation checkpoints — no way to verify that masking preserved critical data or that compaction didn't lose essential state. For operations that could lose context irreversibly, this is a significant gap. | 2 / 3 |
Progressive Disclosure | References to masking.md, compaction.md, and implementation.md are listed, but no bundle files are provided, meaning all referenced content is missing. The skill defers critical implementation details ('See references/implementation.md for masking patterns') to files that don't exist, making the references dead ends rather than progressive disclosure. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 9 / 11 Passed | |
556618c
Table of Contents
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.