CtrlK
BlogDocsLog inGet started
Tessl Logo

common-context-optimization

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

Quality

51%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/common/common-context-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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')

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.