CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-engineering

Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure rules files and context for a project.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/context-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable, well-structured instructional skill — its templates, trust taxonomy, and session-boundary contract are concrete and copy-paste ready, and its sub-workflows carry explicit validation checkpoints. The main costs are token efficiency (persuasion-oriented and conceptual sections pad the file) and the lack of a unified trigger-to-procedure sequence tying the workflows together.

Suggestions

Delete the 'Common Rationalizations' table and the conceptual framing in the Overview (including the Liu et al., 2023 citation) — they argue for the practice rather than instruct the agent, and Claude already knows these effects.

Move detail-level blocks (the full CLAUDE.md template, the MCP server catalog, the confusion-management script examples) into references/ files and keep SKILL.md as a lean overview with one-line pointers, also improving progressive disclosure.

Add a short 'Workflow' section that routes each 'When to Use' trigger to its ordered procedure (e.g., quality degrading → apply the cut/protect/compress/order budget sequence → verify against the checklist), closing the workflow-clarity gap.

DimensionReasoningScore

Conciseness

The bulk is dense, non-obvious actionable guidance (hierarchy, packing templates, cut/protect lists, session boundaries), but several sections are padding: the conceptual Overview, the 'Common Rationalizations' table (persuasion aimed at skeptical humans, not instruction), the MCP server catalog, and the lost-in-the-middle explanation citing 'Liu et al., 2023' — concepts Claude already knows. That is more than the 'minor instances' of score 4 but well short of heavily padded.

3 / 5

Actionability

Copy-paste-ready templates throughout: a complete CLAUDE.md template with real commands ('npm run build', 'npx tsc --noEmit'), the Selective Include block with realistic file paths, worked confusion-surfacing examples with option sets, the 5-item session-boundary persistence list, and the trust-level taxonomy. Per the rubric's scoring note for instruction-only skills, the absence of executable code is not penalized when guidance is this actionable, and the examples cover the common cases.

5 / 5

Workflow Clarity

Sub-workflows are clearly sequenced with explicit checkpoints — numbered pre-task loading steps, stop-and-ask gates in confusion management, re-run-verification conditions for restarted sessions, and a final Verification checklist. However, no unified end-to-end procedure routes the 'When to Use' triggers (e.g., 'quality degrades mid-session') to an ordered sequence; the reader must assemble the flow from reference sections, which fits 'most checkpoints present; minor gaps' rather than score 5.

4 / 5

Progressive Disclosure

A well-organized single file: clear headers, scannable tables, no nested references, and no wall of text; no bundle files exist, and the guidance-level content is appropriately inline. The minor gap is length — the CLAUDE.md template, MCP catalog, and confusion-management scripts are detail-level blocks that could live in references/ files to keep the SKILL.md overview leaner, which keeps it below score 5's ideal split.

4 / 5

Total

16

/

20

Passed

Description

70%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 solid description with an explicit, multi-trigger 'Use when...' clause in third-person voice and a clear domain niche. Its main weakness is the generic 'what' — 'Optimizes agent context setup' names only one concrete capability (configuring rules files), leaving the skill's actual breadth (context packing, budget management, session boundaries) unstated.

Suggestions

Replace the generic 'Optimizes agent context setup' with 2-3 concrete capabilities, e.g., 'Sets up rules files (CLAUDE.md, AGENTS.md), structures context loading per task, and manages context budget during long sessions'.

Add high-recall trigger terms users naturally say, such as 'CLAUDE.md', 'agent hallucinating APIs', or 'agent ignoring conventions', to sharpen both trigger quality and distinctiveness.

DimensionReasoningScore

Specificity

Names the domain ('agent context setup') and 1-2 actions ('Optimizes agent context setup' is generic; 'configure rules files and context for a project' is the one concrete action), matching the score-3 anchor. It does not list several specific actions (structuring context hierarchy, packing strategies, budget management, confusion handling), so it falls below the score-4 anchor.

3 / 5

Completeness

Explicitly answers 'when' with multiple concrete triggers ('Use when starting a new session, when agent output quality degrades, when switching between tasks...') and answers 'what' with 'Optimizes agent context setup'. The 'what' is generic — a single abstract action rather than the multiple concrete capabilities of the score-5 example — so it fits the score-4 anchor with both present but one weaker.

4 / 5

Trigger Term Quality

Includes natural phrases users would say: 'starting a new session', 'agent output quality degrades', 'switching between tasks', 'configure rules files'. A few natural terms are missing — e.g., 'CLAUDE.md', 'hallucinating', 'agent ignoring conventions', 'compact' — which keeps it below the comprehensive synonym-level coverage of score 5 but above the sparse keyword coverage of score 3.

4 / 5

Distinctiveness Conflict Risk

The core niche (context setup, rules files) is distinct with dedicated triggers, but 'starting a new session' and 'switching between tasks' are broad enough to overlap with session-management or planning skills. This matches 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict clarity of score 5.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

addyosmani/agent-skills

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.