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

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 ./.agents/skills/common/common-context-optimization/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 lean, well-structured policy skill with a clear five-step workflow and exemplary progressive disclosure into three real, one-level-deep reference files. Its weakness is actionability: the body states what to preserve and measure but leaves the how — projection procedure, artifact-reference format, compaction mechanics — entirely to the references without a worked example.

Suggestions

Add one worked example of a projected output (a summary plus a stable artifact reference, as in masking.md) to the body or explicitly point readers to it, so the core 'project after consumption' action is executable from SKILL.md alone.

Insert an explicit validation checkpoint before compaction (e.g., 'verify evidence, decisions, and verification receipts are stored at stable references, then compact') with a re-check loop if anything is missing.

Trim the duplication between Workflow steps and Anti-Patterns — the fixed-threshold rule and the no-history-rewrite rule each appear in both sections — keeping one canonical statement per constraint.

DimensionReasoningScore

Conciseness

The body is dense, assumes Claude's competence, and explains no background concepts; the only trimmable material is the do/don't duplication where Anti-Patterns restate workflow constraints (e.g., "never... rely on a fixed turn/token threshold" vs "not a universal turn/token count"). Not a 5 because of that minor redundancy; not a 3 because there is no unnecessary explanation or padding.

4 / 5

Actionability

The steps include concrete lists ("Carry goal, active slice, authority, decisions, blockers, evidence links, and next action"; "Measure cache reads, replayed input, and total actor cost"), but execution-level detail — how to actually project an output or what a stable artifact reference looks like — is delegated to the reference files with no worked example or procedure in the body itself. Not a 4 because an instruction-only skill still needs its core action to be executable from the body; not a 2 because the directives are specific rather than high-level hints.

3 / 5

Workflow Clarity

The five-step sequence (Inspect, Project, Bound, Compact, Measure) is clearly ordered and carries explicit checkpoints ("Compact only when useful and supported", "Archive required packets, reports and receipts at durable references before cleanup") plus a terminal measurement step. Not a 5 because there is no explicit error-recovery or re-validation loop; not a 3 because the checkpoints are stated rather than merely implicit.

4 / 5

Progressive Disclosure

The body is a concise overview with Workflow, Anti-Patterns, and References sections, and the three references (compaction.md, masking.md, implementation.md) all exist, are one level deep with no nested references, and are clearly signaled with descriptive titles. Content is appropriately split, matching the anchor-5 example.

5 / 5

Total

16

/

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 states what the skill does and when to use it, with a well-scoped niche in context and orchestration cost management. Its main weakness is that the capability statement rests on a single generic verb ("Manage") rather than enumerating the concrete actions the body actually covers.

DimensionReasoningScore

Specificity

"Manage context and prompt-cache costs without losing task state" names the domain and one governing action-constraint, but does not enumerate several concrete capabilities (e.g., projecting outputs, compacting, measuring cache costs) the way the anchor-4 example does. It is above a 2 because it goes beyond bare domain naming by specifying the cost-versus-state tradeoff.

3 / 5

Completeness

It clearly 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.

5 / 5

Trigger Term Quality

"Use for context management, orchestration cost, token budgets, large tool outputs, cache misses, or long-running conversations" covers several natural phrases a user would say, but misses common synonyms such as "reduce tokens", "summarize history", or "trim context", so it falls short of the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The prompt-cache-cost/orchestration niche ("prompt-cache costs", "orchestration cost", "cache misses") is mostly distinct from other skills, with only minor overlap risk against generic summarization/history skills via "context management" and "long-running conversations". Not a 5 because of that overlap; not a 3 because the triggers anchor it to a specific niche.

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.