CtrlK
BlogDocsLog inGet started
Tessl Logo

context-fundamentals

This skill should be used to explain or reason about the foundational concepts of context engineering: what context is, the anatomy of a context window, how attention mechanics work, the U-shaped attention curve, why context quality matters more than quantity, and the mental models needed to interpret every other context-engineering decision. Use this for conceptual explanation, onboarding, and background reading. Route operational work to the specialized skills: debugging attention failures goes to context-degradation, token-efficiency work goes to context-optimization, conversation summarization goes to context-compression, and project-shape decisions go to project-development.

60

Quality

75%

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

Quality

Content

56%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 well-structured conceptual skill with genuinely actionable heuristics, but it suffers from significant redundancy — sibling-skill routing repeated four-plus times, ML-concept explanations Claude already knows, and content duplicated with the reference file — plus an undiscoverable script bundle file. Tightening the repetition and deferring detail to the references would materially improve it.

Suggestions

Consolidate the sibling-skill routing that currently appears in the intro, 'When to Activate', 'Integration', and 'References' sections into a single routing map; the repetition costs tokens without adding signal.

Reference scripts/context_manager.py from the body (e.g., in 'Practical Guidance' with a 'Read when' trigger) so the largest bundle file is discoverable.

Trim the 'Context Windows and Attention Mechanics' explanations of known transformer behavior (n-squared attention, position encoding interpolation) to the design implications only, and defer the per-component detail duplicated in references/context-components.md to that file.

DimensionReasoningScore

Conciseness

The body is noticeably padded: routing/dispatch information appears four or more times (intro paragraph, 'Do not activate this skill for operational work', 'Routing map for operational work', 'Related skills in this collection'), and sections like 'The Attention Budget' and 'Position Encoding Limits' restate transformer attention mechanics Claude already knows. It is not a 1 because the material is not generic filler — it is domain-relevant — but well above the lean 5 anchor.

2 / 5

Actionability

For an instruction-only skill the guidance is concrete and specific: the signal-density test ('ask whether removing it would change the model's output. If not, remove it'), 'compaction triggers at 70-80% utilization', tool descriptions answering three questions, and semantic-boundary chunking. It falls short of 5 only because some guidance (e.g., 'monitor context usage') lacks an executable mechanism.

4 / 5

Workflow Clarity

'Reasoning About a Context Decision' gives a clear two-part separation procedure with a worked example, and 'Reading Order For New Contributors' is an explicit sequenced path. No destructive or batch operations exist, so no validation cap applies; it does not reach 5 because there is no true multi-step operational workflow with error-recovery checkpoints.

4 / 5

Progressive Disclosure

The single reference (references/context-components.md) is real and well signaled with 'Read when' triggers, but the 18KB scripts/context_manager.py bundle file is never mentioned anywhere in the body, leaving it undiscoverable. Additionally, body content (section structure, altitude calibration) duplicates the reference file rather than deferring to it — a clear organization gap that anchors 4's 'minor organization gaps' do not cover.

3 / 5

Total

13

/

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 what/when pair and unusually good sibling-skill routing that reduces conflict risk. Its weaknesses are mild: mostly topical rather than action-verb phrasing and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capabilities ('explain or reason about the foundational concepts', 'anatomy of a context window', 'the U-shaped attention curve', 'mental models') plus explicit routing actions. It stops short of the 5 anchor because the phrasing is topical enumeration rather than a comprehensive list of concrete actions.

4 / 5

Completeness

It explicitly answers both questions: the 'what' via an enumerated list of foundational concepts and the 'when' via 'Use this for conceptual explanation, onboarding, and background reading', with concrete negative routing to sibling skills. This matches the 5 anchor; the 4 anchor would apply only if the 'when' were weaker or implicit.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'context engineering', 'context window', 'attention', 'onboarding', 'background reading', 'mental models'. A few natural user phrases are missing (e.g., 'long context', 'prompt engineering', 'token budget'), placing it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The explicit routing map ('debugging attention failures goes to context-degradation, token-efficiency work goes to context-optimization...') sharply delineates the niche, but as the foundational skill of the entire collection it retains some overlap surface with its siblings on general context questions, so it does not fully reach the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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
muratcankoylan/Agent-Skills-for-Context-Engineering
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.