CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-engineering

Optimize Claude Code context usage through monitoring, reduction strategies, progressive disclosure, planning/execution separation, and file-based optimization. Task-based operations for context window management, token efficiency, and maintaining conversation quality. Use when managing token costs, optimizing context usage, preventing context overflow, or improving multi-turn conversation quality.

Quality

69%

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-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

45%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 excels at workflow clarity (well-sequenced operations with checklists and a routing decision tree) but is heavily padded with quadruple-repeated content and explanations of concepts Claude already knows. More seriously, it advocates progressive disclosure while itself being a 757-line monolith whose four advertised bundle files do not exist, making its central references dangling.

Suggestions

Create the advertised bundle files (references/context-monitoring-guide.md, references/reduction-strategies.md, references/optimization-patterns.md, scripts/analyze-context-usage.py) or remove the 'For More Information' pointers entirely, since every reference is currently broken.

Deduplicate the content repeated across the Overview, Operations, Best Practices, and Quick Reference sections, keeping each fact (e.g., the 95% file-based savings figure, the >5,000-token threshold) in exactly one place, to cut roughly 300-400 lines.

Move the token-budget tables, mistake catalog, and worked-example transcripts into references/ files and trim explanations of things Claude already knows (Grep vs. Read behavior, tables being denser than prose), leaving SKILL.md as the lean overview the skill's own rules prescribe.

DimensionReasoningScore

Conciseness

The 757-line body repeats the same material roughly four times (Overview list, per-Operation detail, Best Practices, Quick Reference tables) and re-states the same figures ('70-80%', '95% token savings', '>5,000 tokens') in at least five places. It also explains concepts Claude already knows (Grep vs. Read, 'tables instead of prose'), matching the 'noticeably verbose; several unnecessary explanations or padded sections' anchor rather than the occasional-tightening-possible level of a 3.

2 / 5

Actionability

Concrete guidance exists (the /context command, usage-threshold tables, a decision tree, bash redirects to /tmp/), but key commands are illustrative pseudo-syntax ('Read file_path --limit 50', 'Grep "pattern" path/'), examples are hypothetical transcripts rather than executable procedures, and the promised automation (scripts/analyze-context-usage.py) does not exist. This lands at 'some concrete guidance but incomplete' rather than the mostly-executable level of a 4.

3 / 5

Workflow Clarity

Each of the five operations is clearly sequenced with Purpose, When to Use, Process, a Validation Checklist, and Outputs, and a decision tree routes between them with before/after measurements. Checklists are assertion-style rather than explicit validate-then-fix-then-retry feedback loops, so it sits at 'clear sequence with most checkpoints present' rather than a 5.

4 / 5

Progressive Disclosure

The 'For More Information' section points to references/context-monitoring-guide.md, references/reduction-strategies.md, references/optimization-patterns.md, and scripts/analyze-context-usage.py, but no references/ or scripts/ directories exist in the bundle, so every reference is broken. Meanwhile several hundred lines of token-budget tables, mistake catalogs, and worked examples are inlined in SKILL.md that, by the skill's own doctrine, belong in reference files. This matches the 'minimal structure; content that clearly belongs in separate files is inlined; or references are buried' anchor rather than a 3, since the references are not merely unsignaled but absent.

2 / 5

Total

11

/

20

Passed

Description

83%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 with an explicit 'Use when...' clause, multiple natural trigger terms, and a well-delineated niche. Its only weaknesses are mild abstraction in naming the operations and a few missing synonym variations in the trigger phrases.

DimensionReasoningScore

Specificity

The description names five distinct operations ('monitoring, reduction strategies, progressive disclosure, planning/execution separation, and file-based optimization'), giving several specific actions with only minor abstraction ('reduction strategies'). It exceeds the 1-2-action level of a 3 but stops short of the fully concrete, comprehensive coverage of a 5.

4 / 5

Completeness

It explicitly answers both what ('Optimize Claude Code context usage through...') and when ('Use when managing token costs, optimizing context usage, preventing context overflow, or improving multi-turn conversation quality') with concrete trigger phrases. This matches the anchor that clearly and explicitly answers both; the 'when' clause is explicit rather than weakly implied, so it is not a 4.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ('managing token costs', 'optimizing context usage', 'preventing context overflow', 'improving multi-turn conversation quality'), plus 'context window management' and 'token efficiency'. Coverage is good but misses common variations such as 'context limit', 'reduce token usage', or 'compaction', so it falls just short of the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Claude Code context/token management) with distinct triggers ('token costs', 'context overflow', 'multi-turn conversation quality') that are unlikely to fire the wrong skill. Minor overlap risk remains with skills about skill-authoring or documentation efficiency, keeping it below a 5.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (757 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

13

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/context-engineering/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.