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.

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

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.

The body is an exemplary lean overview: a tightly sequenced workflow, explicit anti-pattern guardrails, and clean progressive disclosure to three real, well-scoped reference files. The only meaningful gaps are mildly abstract implementation phrasing and the absence of a concrete worked example or explicit error-recovery loop in the main file.

DimensionReasoningScore

Conciseness

The ~23-line body is lean and imperative with zero padding ('Project outputs after consuming them: retain decisions, evidence, errors, and required values') and never explains concepts Claude already knows. Every token earns its place, matching the 5 anchor; there is nothing to trim that would justify 4.

5 / 5

Actionability

Directives are concrete with specific content lists ('Carry goal, active slice, authority, decisions, blockers, evidence links, and next action'; 'Measure cache reads, replayed input, and total actor cost'), which is actionable guidance for an instruction-only skill. It stops short of 5 because phrases like 'host-supported boundaries' and 'stable append-only prefix where supported' stay abstract, and no worked example (e.g., a handoff packet) appears in the body.

4 / 5

Workflow Clarity

A clear, logical 5-step sequence (Inspect, Project, Bound, Compact, Measure) with embedded checkpoints such as inspecting capabilities before acting and requiring measured evidence before any savings claim. It is not 5 because there is no explicit validate-then-fix-then-retry feedback loop; checkpoints are present but partially implicit.

4 / 5

Progressive Disclosure

SKILL.md is a concise overview with a clearly signaled References section pointing to three one-level-deep files (compaction.md, masking.md, implementation.md), all verified to exist with no nested references and with detail content appropriately split out of the main file. This matches the 5 anchor of a clear overview with well-signaled one-level-deep references.

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 strong description that explicitly covers both what the skill does and when to use it, with a solid set of natural trigger terms for a genuinely niche domain. Its main weakness is that the capability statement rests on one generic verb ('Manage') rather than listing the concrete actions the skill actually performs.

DimensionReasoningScore

Specificity

The description names its domain clearly ('Manage context and prompt-cache costs without losing task state') but relies on a single governing verb rather than enumerating several concrete actions, matching 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not 4 because the distinct operational actions (inspect, project, compact, measure) are only found in the body, not the description.

3 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Manage context and prompt-cache costs without losing task state') and an explicit 'Use for...' clause enumerating concrete trigger conditions. The 'when' is a specific enumerated list rather than merely present, matching the 5 anchor.

5 / 5

Trigger Term Quality

'context management, orchestration cost, token budgets, large tool outputs, cache misses, or long-running conversations' provides good natural keyword coverage of the domain. It falls short of 5 because common user phrasings like 'reduce tokens', 'summarize history', or 'context window' appear only in metadata triggers, not the description itself.

4 / 5

Distinctiveness Conflict Risk

Niche triggers like 'prompt-cache', 'cache misses', and 'orchestration cost' carve a clear niche with minimal conflict risk, but broader phrases ('context management', 'long-running conversations') could overlap with general summarization or compaction skills. Mostly distinct with minor overlap risk, so 4 rather than 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

.github/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.