CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

common-context-optimization

Manage context and prompt-cache costs without losing task state. Use for context management, orchestration cost, token budgets, large tool outputs, cache misses, or long-running conversations.

67

Quality

84%

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

The canonical home for this skill is common-context-optimization in HoangNguyen0403/agent-skills-standard

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-structured instruction skill: an efficient five-step workflow with concrete carry/retain/measure lists, explicit anti-patterns, and a clean one-level-deep reference bundle that was verified to exist. The only gaps are method-level detail for host-capability inspection and the absence of an explicit error-recovery feedback loop.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and directive with zero filler: every step ("Project outputs after consuming them: retain decisions, evidence, errors..."), anti-pattern, and reference earns its place, and nothing explains concepts Claude already knows. Not a 4 because there are no over-explanation instances to trim.

5 / 5

Actionability

As an instruction-only skill it gives specific, executable guidance — exact lists of what to carry ("goal, active slice, authority, decisions, blockers, evidence links, and next action"), what to measure ("cache reads, replayed input, and total actor cost"), and explicit prohibitions. It falls short of 5 because steps like "Inspect host capabilities" and "Bound context at host-supported boundaries" state what to do without any method for doing it.

4 / 5

Workflow Clarity

The five steps (Inspect → Project → Bound → Compact → Measure) are clearly sequenced with guardrail conditions ("Compact only when useful and supported", "never discard source evidence") and a measurement/verification step. It is not a 5 because there is no explicit error-recovery feedback loop (e.g., what to do when measurement reveals replayed input or a compaction failure).

4 / 5

Progressive Disclosure

The body is a clear overview whose details are appropriately split into three real, one-level-deep reference files (verified: references/compaction.md, references/masking.md, references/implementation.md all exist, contain substantive content, and reference no further files), listed with descriptive labels for easy navigation.

5 / 5

Total

18

/

20

Passed

Description

78%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 well-constructed description with an explicit what/when structure and good natural trigger terms. Its main weakness is that the capability statement is a single governing action over a domain rather than a list of concrete capabilities, and a few common synonym triggers are missing.

Suggestions

Enumerate the concrete capabilities as distinct verb phrases, e.g. "Compact conversation history, project large tool outputs to artifact references, and measure cache-read and replay costs" instead of the single verb "Manage".

Add natural synonym trigger phrases users would say, such as "reduce tokens", "trim context", or "summarize conversation history", to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Manage context and prompt-cache costs without losing task state" names the domain and one governing action with a concrete constraint, but does not enumerate several distinct concrete actions the way the anchor-4 example does ("Extracts text..., fills forms, converts pages...").

3 / 5

Completeness

It explicitly answers both "what" ("Manage context and prompt-cache costs without losing task state") and "when" ("Use for context management, orchestration cost, token budgets, large tool outputs, cache misses, or long-running conversations") with concrete trigger phrases, matching the anchor-5 example structure. It is not a 4 because the 'when' clause is explicit and specific rather than vague.

5 / 5

Trigger Term Quality

"context management, orchestration cost, token budgets, large tool outputs, cache misses, long-running conversations" gives good natural-keyword coverage, but common variations users would say ("reduce tokens", "trim context", "summarize history") are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

The prompt-cache/orchestration-cost niche is mostly distinct with domain-specific triggers, but "context management" and "large tool outputs" are broad enough to overlap with summarization or output-management skills, so it does not reach the minimal-conflict anchor 5.

4 / 5

Total

16

/

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

Path

.agents/skills/common/common-context-optimization/SKILL.md

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.