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 overflow the context, conversations drift from intent, or latency spikes from cache misses.

62

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

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 lean, well-structured overview with excellent progressive disclosure and concrete thresholds. Its weaknesses are the in-body masking mechanism being underspecified (delegated to references) and the absence of validation checkpoints for destructive history-rewriting operations.

Suggestions

Add a brief validation checkpoint to the compaction/masking workflows (e.g., 'Verify the summary preserves Goal, Active Task, and Current Errors before dropping raw history') to lift workflow clarity.

Include one minimal in-body masking example showing the before/after rewrite mechanism, or make explicit that the executable pattern lives in references/masking.md, so the core action is not left abstract.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: Problem/Solution framing with tight numbered steps and specific thresholds, e.g. 'Identify outputs exceeding 50 lines or 1 KB' and 'Trigger compaction every 10 turns or 8k tokens', without explaining concepts Claude already knows. It is not a 2 because there is no padding or unnecessary explanation; minor reference redundancy is not enough to drop it.

3 / 3

Actionability

Concrete thresholds and explicit keep/drop lists ('Keep: User Goal, Active Task, Current Errors, Key Decisions') and ordering ('System -> Tools -> RAG -> User') are actionable, but the core masking mechanism is abstract in-body ('replace raw data with summary placeholder') with execution details delegated to references. It is not a 3 because the key 'how' of masking/rewriting history is incomplete in the body, and not a 1 because the guidance is specific and instructive.

2 / 3

Workflow Clarity

Sections 1 and 2 present clear numbered sequences (Identify -> Extract -> Mask; Trigger -> Compact -> Format), but there are no validation checkpoints or feedback loops, and masking/compaction are destructive history-rewriting operations. Per the rubric, missing validation for destructive operations caps this at 2; it is not a 1 because sequences are clearly listed.

2 / 3

Progressive Disclosure

The body is an overview pointing to well-signaled one-level-deep references ([references/masking.md], [references/compaction.md], [references/implementation.md]); the bundle files exist and are self-contained with no further nesting. Content is appropriately split (overview in body, patterns/algorithms/examples in references). It is not a 2 because navigation is clear and references are not deeply nested.

3 / 3

Total

10

/

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 strong on specificity and completeness, using third person and an explicit 'Use when' clause with concrete techniques. Its weaknesses are trigger-term naturalness (technical jargon) and some overlap risk with summarization skills.

Suggestions

Replace technical jargon ('lost-in-middle issues', 'cache misses') with user-natural phrasings in the 'Use when' clause to improve trigger-term quality.

Sharpen distinctiveness by anchoring triggers to context-window-specific symptoms (e.g., 'context window is full', 'need to free up tokens before continuing') rather than general 'summarize history' phrasing that overlaps with summarization skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person: 'Maximize context window efficiency, reduce latency, and prevent lost-in-middle issues through strategic masking and compaction.' These name specific techniques (masking, compaction) rather than vague abstraction, matching the multiple-concrete-actions anchor; it is not a 2 because it goes beyond naming a domain and a couple of actions.

3 / 3

Completeness

Clearly answers both what ('Maximize context window efficiency... through strategic masking and compaction') and when via an explicit 'Use when token budgets are tight, tool outputs overflow the context, conversations drift from intent, or latency spikes from cache misses' clause. It is not a 2 because the 'when' is explicit rather than implied.

3 / 3

Trigger Term Quality

The 'Use when' clause offers some natural triggers ('token budgets are tight', 'tool outputs overflow the context', 'conversations drift from intent'), but leans on technical jargon like 'lost-in-middle issues' and 'cache misses' that users would not naturally say, missing common variations. It is not a 3 because the keyword set is not consistently natural, and not a 1 because several phrases are usable triggers.

2 / 3

Distinctiveness Conflict Risk

The context-window-optimization niche is fairly specific, but triggers like 'summarize history' and 'conversations drift from intent' overlap with general summarization/compaction skills, so it could still trigger for the wrong skill. It is not a 3 because the niche is not cleanly separated from adjacent skills, and not a 1 because it is not generically broad.

2 / 3

Total

10

/

12

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.

Validation14 / 16 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

14

/

16

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.