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

74%

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

The canonical home for this skill is context-engineering in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

51%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 structure — five well-sequenced operations with checklists, a decision tree, and before/after feedback loops — but undermines itself on efficiency and disclosure. It is ~756 lines of heavily duplicated guidance (operations, best practices, mistakes, and quick-reference tables all restate the same numbers), and its progressive-disclosure references point to files that don't exist in the bundle.

Suggestions

Create the referenced 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 — dangling references break navigation and the skill's own progressive-disclosure guidance.

Collapse the Best Practices, Common Mistakes, and Quick Reference sections, which restate the five operations and the same thresholds (70-80%, 95%, >5,000 tokens) already covered per-operation; keep one summary table and move worked examples to references/ to cut the body by roughly half.

Replace pseudocode commands ('Read file_path --limit 50', 'Grep "pattern" path/') with actual invocations, and state explicitly which reductions (clearing tool results, unloading files) have no user command and rely on auto context-editing, so the actionable steps are executable as written.

DimensionReasoningScore

Conciseness

The 756-line body is noticeably verbose and self-contradictory: the Best Practices section ("Progressive Disclosure Always", "File-Based for Large Data"), Common Mistakes (Mistakes 1-6), and Quick Reference tables restate the same five operations, token thresholds (">5,000 tokens", "95% token savings"), and numbers already given in full inside each Operation — several padded, duplicated sections. It is above anchor 1 because it does not extensively explain concepts Claude already knows (no tutorial on what a context window is); it is below anchor 3 because the duplication of "Time Estimate", "Outputs", and examples across five operations plus three summary sections could be cut roughly in half without losing information.

2 / 5

Actionability

There is concrete guidance — the "/context" command, explicit thresholds (">60-70% usage", "SKILL.md <1,200 lines", "data >5,000 tokens"), the temp-file pattern with real bash, a routing decision tree, and a line-to-token estimation heuristic — but key mechanisms are incomplete: Operation 2's core steps ("Remove Stale Tool Results", "Unload files when done") give no executable means of doing so, the "Common Commands" block is pseudocode ("Read file_path --limit 50", "Grep \"pattern\" path/\""), and the cited "scripts/analyze-context-usage.py" does not exist in the bundle. This lands on anchor 3 (some concrete guidance but incomplete, pseudocode mixed with real commands) rather than 4's 'concrete code or commands with minor gaps'.

3 / 5

Workflow Clarity

Each of the five operations has a numbered Process, an explicit "Validation Checklist", When-to-Use criteria, and Outputs; the "Optimization Decision Tree" routes conditions to operations; and a measure-reduce-re-measure feedback loop is built in ("Document Baseline", "Token savings measured (before/after)"). This matches anchor 5 — clear sequence, explicit validation steps, feedback loops, and checklists — and exceeds anchor 4, which only requires most checkpoints.

5 / 5

Progressive Disclosure

The bundle contains no references/, scripts/, or assets/ files, yet the body's "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" — four dangling references. Meanwhile content that clearly belongs in separate files (per the skill's own "SKILL.md: Overview + essentials only" rule) is inlined: full worked examples, token-budget tables, and the entire Common Mistakes catalog. This matches anchor 2 (content that belongs in separate files is inlined; navigation is broken) better than anchor 3, because the signaling exists but the referenced files do not.

2 / 5

Total

12

/

20

Passed

Description

88%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: it names the five concrete operations, states clear value propositions, and closes with an explicit 'Use when' clause containing natural trigger phrases. Only minor gaps — a few missing trigger synonyms (e.g., 'compaction', 'context window full') and slight overlap risk with skill-design skills.

DimensionReasoningScore

Specificity

Lists multiple concrete, domain-specific actions: "monitoring, reduction strategies, progressive disclosure, planning/execution separation, and file-based optimization" plus "context window management, token efficiency, and maintaining conversation quality" — comprehensive coverage of the skill's operations, matching the anchor for multiple specific concrete actions. It sits above anchor 4 because the action list covers the skill's full operation set, not just a partial selection.

5 / 5

Completeness

Explicitly answers both questions: the "what" via "Optimize Claude Code context usage through monitoring, reduction strategies..." and the "when" via a concrete trigger clause "Use when managing token costs, optimizing context usage, preventing context overflow, or improving multi-turn conversation quality." This matches the anchor-5 example structure (capability list + 'Use when' with concrete trigger phrases) exactly; it is not anchor 4 because the 'when' is explicit and specific rather than merely present.

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". It falls short of anchor 5's comprehensive synonym coverage — common variations like "context window is full", "compaction", or "/context" are missing, but the terms present are ones users would naturally say.

4 / 5

Distinctiveness Conflict Risk

The niche (Claude Code context window/token management) is clear and triggers are domain-specific ("token costs", "context overflow"), but "progressive disclosure" and skill-design framing create minor overlap risk with skill-authoring/design skills — mostly distinct with minor overlap, matching anchor 4 rather than anchor 5's minimal-conflict profile.

4 / 5

Total

18

/

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

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