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.

64

Quality

78%

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

Quality

Content

68%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, token-efficient overview with actionable thresholds and a real, one-level-deep reference bundle. The main gaps are the absence of validation checkpoints before destructive masking/compaction operations (capping workflow clarity at 3) and duplicated, inconsistent reference callouts.

Suggestions

Add explicit validation checkpoints before destructive steps: e.g., 'Verify all critical data points are extracted and confirmed before masking raw output' and 'Confirm compacted state retains Goal, Errors, and Key Decisions before discarding blocks'.

Deduplicate reference callouts — each section currently cites references twice (an inline 'See references/X.md' step followed by a linked 'See [implementation examples]' line); consolidate into a single, consistently-formatted References section that includes implementation.md.

Give the KV-Cache section a concrete ordering example or move its detail to a reference file, since it is currently the only section without either a sequence or a supporting reference.

DimensionReasoningScore

Conciseness

The body is lean — Problem/Solution framing with short numbered steps and no over-explanation of concepts Claude already knows. It falls short of 5 due to duplicated reference callouts (each section has both a 'See references/X.md' step and a following 'See [implementation examples]' line) and the low-value 'Priority: P1 (HIGH)' header.

4 / 5

Actionability

Concrete thresholds and specifics are given: 'outputs exceeding 50 lines or 1 KB', 'every 10 turns or 8k tokens', explicit Keep/Drop lists, and 'System -> Tools -> RAG -> User' ordering. It is not a 5 because 'Mask by rewriting history' and 'Update System Prompt or Memory File' lack any mechanism-level example in the body (all concrete examples are pushed to reference files).

4 / 5

Workflow Clarity

Sections 1 and 2 have clear numbered sequences, but the destructive operations — masking rewrites history to discard raw outputs and compaction discards blocks — have no validation checkpoints (e.g., confirm critical data was extracted before masking). Per the rubric's cap for destructive operations without validation, workflow clarity cannot exceed 3.

3 / 5

Progressive Disclosure

All three referenced files (references/masking.md, compaction.md, implementation.md) exist, are one level deep, and the body is a genuine overview with details appropriately split out. It falls short of 5 because reference pointers are redundant and inconsistent — a plain-text 'See references/masking.md' step plus a separate linked 'implementation examples' line per section, and the References section omits implementation.md.

4 / 5

Total

15

/

20

Passed

Description

87%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: it names concrete techniques, includes an explicit and specific 'Use when...' trigger clause, and occupies a distinct niche. The only weaknesses are the mild buzzword framing of 'Maximize context window efficiency' and a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — 'strategic masking and compaction', 'reduce latency', 'prevent lost-in-middle issues' — alongside the domain of context window management, with only minor coverage gaps. It falls just below a 5 because 'Maximize context window efficiency' is an outcome-level buzzword rather than a concrete action, and just above 3 because more than 1-2 specific actions are named.

4 / 5

Completeness

Both parts are explicit: the 'what' is masking/compaction for context efficiency, latency, and lost-in-middle prevention, and the 'when' is a full 'Use when...' clause with four concrete trigger conditions. This matches the anchor for clearly and explicitly answering both what and when.

5 / 5

Trigger Term Quality

Trigger phrases like 'token budgets are tight', 'tool outputs overflow the context', 'conversations drift from intent', and 'latency spikes from cache misses' are natural ways a user would describe needing this skill. A few common variations are missing (e.g., 'context is full', 'summarize the history', 'trim the conversation'), keeping it below the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche is narrow and technical — context window management via masking/compaction/KV-cache — and its triggers ('tool outputs overflow the context', 'latency spikes from cache misses') are unlikely to fire for unrelated skills. Only very slight overlap with generic summarization skills exists, which is minimal conflict risk.

5 / 5

Total

18

/

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

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.