CtrlK
BlogDocsLog inGet started
Tessl Logo

context-optimization

This skill should be used for improving context efficiency: context budgeting, observation masking, prefix or KV-cache strategy, partitioning, token-cost reduction, retrieval scoping, and extending effective context capacity without lowering answer quality.

60

Quality

75%

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

Quality

Content

70%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, highly actionable strategy skill with an exemplary measure-apply-validate workflow and feedback loops. Its weaknesses are redundancy between the Core Concepts and Detailed Topics sections, pseudocode examples with undefined functions, and a progressive-disclosure gap: the bundled scripts/compaction.py is never referenced and external resources are unnamed placeholders.

Suggestions

Reference scripts/compaction.py from the body with a 'Read when' clause (and remove it from the bundle if it is not meant to be used), so every bundle file is navigable.

Deduplicate Core Concepts vs. Detailed Topics — state each strategy's trigger and priority once, and push per-message-type preservation rules and threshold detail into references/optimization_techniques.md.

Replace the pseudocode examples' undefined calls (compact_context, store_observation, extract_key) with runnable snippets or drop the Examples section in favor of the reference file's patterns.

DimensionReasoningScore

Conciseness

Mostly efficient tactical content, but Core Concepts restates Detailed Topics (the 70% compaction trigger and each strategy's summary appear twice), and it explains fundamentals Claude already knows ("KV-cache stores Key and Value tensors computed during inference..."), plus a metadata block with version dates. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'. Not 2: the bulk is genuinely additive, non-padded guidance.

3 / 5

Actionability

Highly concrete guidance: specific thresholds (70%/80% triggers, 50-70% reduction, <5% degradation), a decision-framework table, byte-level cache-stability rules, and specific gotcha mitigations ("suspend masking for all error-related observations", "batch such edits"). Not 5: the code examples call undefined functions (compact_context, store_observation, extract_key) — illustrative pseudocode rather than executable code.

4 / 5

Workflow Clarity

Full explicit workflow with validation and feedback loops: "Measure before optimizing, then measure the optimization's effect"; a decision-framework table for technique selection; a priority order; tracked performance targets; and "If an optimization technique does not measurably improve the target metric, remove it" — plus error-recovery audits ("audit the summary for critical information loss", "re-validate the summary against the current task goal") and an 8-item checklist. Matches the top anchor; not 4: validation checkpoints are explicit at every stage, not just most.

5 / 5

Progressive Disclosure

Good sectioning and one clearly signaled one-level reference (./references/optimization_techniques.md with an explicit 'Read when' clause), but the bundle's scripts/compaction.py (19KB) is never referenced from the body — an orphaned, unnavigable file — and 'External resources' are unnamed topic labels rather than actual links. Significant detail (thresholds, per-message-type preservation rules) is inlined that belongs in the reference file. Matches 'some structure but could be better organized; references present but not clearly signaled' in spirit via the navigation gap. Not 4: the orphaned script and placeholder external resources are more than minor organization gaps.

3 / 5

Total

15

/

20

Passed

Description

67%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 solid description with an explicit trigger clause and a comprehensive enumerated capability list. Its main weaknesses are jargon-heavy trigger terms that users would less naturally say, a 'when' clause that could be more concrete, and modest overlap with adjacent skills in the same family.

Suggestions

Add explicit natural-language trigger phrases users would actually say, e.g., 'Use when the user mentions context window limits, token costs, cache hit rates, or wants to summarize or trim conversation history'.

Name core mechanisms in plain language (compaction/summarization of history, sub-agent splitting) rather than only jargon labels like 'observation masking' and 'partitioning'.

Sharpen the 'when' by separating it from the 'what' clause and stating concrete triggering conditions (e.g., token costs constraining the task, cache misses spiking).

DimensionReasoningScore

Specificity

Enumerates seven concrete capability areas ("context budgeting, observation masking, prefix or KV-cache strategy, partitioning, token-cost reduction, retrieval scoping"), matching 'lists several specific actions; minor gaps'. Not 5: terms remain jargon-abstract and omit core mechanisms the body covers (e.g., compaction/summarization). Not 3: coverage clearly exceeds 1-2 actions.

4 / 5

Completeness

Explicit 'what' (the enumerated capability list) plus an explicit trigger clause ("This skill should be used for improving context efficiency"), so the missing-trigger cap at 3 does not apply. Not 5: the 'when' is folded into the 'what' sentence and lacks concrete user-facing trigger phrases (e.g., 'Use when the user mentions...'), matching 'when could be more explicit or specific'.

4 / 5

Trigger Term Quality

Some relevant natural terms ("context", "token-cost", "KV-cache") but insider phrasing dominates ("observation masking", "retrieval scoping", "partitioning") while common user phrasings like "context window", "reduce token usage", or "summarize conversation history" are missing. Matches 'some relevant keywords but missing common variations or synonyms', not 4 which requires broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

Clear niche with distinct technical triggers, but "partitioning" and "extending effective context capacity" overlap with the skill family's adjacent entries (multi-agent-patterns, context-compression, filesystem-context) that the body itself lists. Matches 'mostly distinct; minor overlap risk with closely related skills'. Not 5: those overlap points are real since this collection defines near-neighbor skills.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.