CtrlK
BlogDocsLog inGet started
Tessl Logo

context-fundamentals

Context is the complete state available to a language model at inference time. It includes everything the model can attend to when generating responses: system instructions, tool definitions, retrieved documents, message history, and tool outputs.

39

Quality

38%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/context-fundamentals/SKILL.md

The canonical home for this skill is context-fundamentals in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

42%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 is a lengthy conceptual primer that re-teaches fundamentals Claude already knows, with a thin layer of actionable guidelines and two illustrative examples. It is well-sectioned but inlines material that belongs in separate reference files, and its references point to non-existent or vague external resources rather than real bundle files.

Suggestions

Cut the re-explanations of known concepts (what system prompts/tool definitions are, attention n² mechanics, position encoding) and keep only the engineering guidance that is non-obvious, collapsing the Detailed Topics section substantially.

Move the detailed per-component material into a real references/ file (e.g. references/context-components.md) and link to it from a concise overview, so SKILL.md becomes a lean pointer rather than a textbook.

Replace vague external pointers ('Research on transformer attention mechanisms', 'Production engineering guides from leading AI labs') with concrete, verifiable references or remove them.

DimensionReasoningScore

Conciseness

The body extensively re-explains concepts Claude already knows — what system prompts and tool definitions are, attention mechanics ('n² relationships'), position encoding, and 'mirrors human cognition: we generally do not memorize entire corpuses' — across ~180 lines of textbook-style prose, fitting the score-2 'noticeably verbose; several unnecessary explanations or padded sections' anchor; it is not score-1 because the closing Guidelines and Examples add some earned tokens.

2 / 5

Actionability

There is some concrete guidance — the XML-tagged prompt template (Example 1), the progressive-loading file-path sketch (Example 2), and specific heuristics like 'Implement compaction triggers at 70-80% utilization' and 'Place critical information at attention-favored positions' — but it is incomplete and buried in conceptual exposition, matching the score-3 'some concrete guidance but incomplete' anchor rather than the mostly-executable score-4 anchor.

3 / 5

Workflow Clarity

This is a conceptual/foundational skill with no multi-step operational workflow; the document is organized into clear sections (When to Use, Detailed Topics, Practical Guidance, Guidelines) providing structural sequence, but there are no validation checkpoints or sequenced task steps, so it sits at the score-3 'sequence present but checkpoints missing' anchor rather than the score-5 simple-skill exception (it is neither simple nor single-action).

3 / 5

Progressive Disclosure

Section headers give the body reasonable structure, but large conceptual 'Detailed Topics' blocks are inlined that could live in separate references, and the cited 'Context Components Reference' is not a real file (no references/ directory exists) while external pointers ('Research on transformer attention mechanisms', 'Production engineering guides from leading AI labs') are vague and not clearly signaled — matching the score-3 'some structure but references not clearly signaled' anchor.

3 / 5

Total

11

/

20

Passed

Description

33%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.

The description defines what context is and lists its components but does not state what the skill does or when to activate it, leaving it definitional rather than action-oriented. It relies on technical jargon over natural trigger terms and is broad enough to conflict with several related context skills.

Suggestions

Rewrite the description as a capability statement with concrete verbs (e.g. 'Curates and structures the high-signal context an agent loads at inference time') and append a 'Use when ...' clause naming concrete triggers (designing agent architecture, debugging context bloat, reducing token costs).

Add natural trigger terms users actually say — 'context window', 'context engineering', 'token budget', 'prompt optimization' — instead of jargon like 'inference time' and 'attend to'.

Narrow the scope or add a distinguishing qualifier so it does not overlap with sibling skills (context-degradation, context-optimization, tool-design).

DimensionReasoningScore

Specificity

The description names the domain precisely ("Context is the complete state available to a language model at inference time") and enumerates its components (system instructions, tool definitions, retrieved documents, message history, tool outputs), but it states no concrete actions the skill performs — it is definitional rather than capability-describing, fitting the score-2 anchor of naming the domain with minimal/generic actions but not the score-1 'entirely vague' anchor.

2 / 5

Completeness

It gives a clear 'what' (defines context and lists its components) but provides no 'when'/Use-when trigger guidance, so per the cap on missing explicit trigger clauses it lands at the score-3 anchor of a clear 'what' with 'when' missing.

3 / 5

Trigger Term Quality

Phrases like 'language model at inference time', 'attend to when generating responses', and the enumerated component names are technical jargon; the natural terms a user would say ('context window', 'context engineering', 'token budget', 'prompt') are absent, matching the score-2 anchor of having a couple of generic keywords while missing the natural phrases users say.

2 / 5

Distinctiveness Conflict Risk

The description spans the entire notion of context (system instructions, tools, retrieval, history, tool outputs), which the body confirms overlaps with sibling skills like context-degradation, context-optimization, tool-design, and multi-agent-patterns — high overlap risk matching the score-2 'very broad; high overlap risk' anchor rather than the more-narrow score-3 anchor.

2 / 5

Total

9

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.