CtrlK
BlogDocsLog inGet started
Tessl Logo

documentation-lookup

Use up-to-date library and framework docs via Context7 MCP instead of training data. Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma).

64

Quality

76%

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 ./.agents/skills/documentation-lookup/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 well-structured, highly actionable single-file skill with an explicit step sequence and guardrails. Its weaknesses are redundancy — tool definitions and step instructions repeated across Core Concepts, Steps, Examples, and Best Practices — and a missing recovery path when library resolution fails or returns ambiguous results.

Suggestions

Merge 'Core Concepts' into Steps 1 and 3 so each tool is defined once alongside its parameters, cutting the double explanation.

Reduce the three near-identical Examples to one fully worked example plus a one-line table of variations (Prisma, Supabase), or keep the differing details only.

Add an error-recovery step: what to do when resolve-library-id returns no match or multiple plausible IDs (retry with a refined query, or ask the user which library they mean).

DimensionReasoningScore

Conciseness

The body is mostly efficient but contains noticeable redundancy: 'Core Concepts' re-explains resolve-library-id and query-docs that Steps 1 and 3 then restate with their parameters, the three Examples each replay the identical 4-step flow, and 'Best Practices' repeats guidance already in Step 2 ('Version awareness', 'Be specific'). It fits the 'could be tightened' anchor rather than the 'minor instances of over-explanation' anchor because whole sections overlap, not just sentences. Nothing explains concepts Claude already knows, which keeps it above 2.

3 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact tool names, exact parameters (libraryName, query, libraryId), the library-ID format ('/org/project'), selection criteria, a hard 3-call limit with an explicit fallback behavior, and three fully worked call sequences. This matches 'concrete, specific guidance' at the top anchor; there are no pseudocode or vague steps.

5 / 5

Workflow Clarity

The 4-step sequence (resolve → select → query → use) is clearly ordered with an explicit precondition ('You must obtain a Context7-compatible library ID before querying docs') and a termination guardrail (3-call limit with 'state the uncertainty'). It is not 5 because there is no error-recovery loop for the main failure mode — resolve-library-id returning no match or an ambiguous list — beyond the generic call limit.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed; the single-file body is well organized into When to use / How it works / Examples / Best Practices with no monolithic inlined reference material. It is not 5 because the body (~82 lines) exceeds the simple-skill threshold and the redundant Examples section is content that could be consolidated or split, leaving minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

78%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 that clearly states what the skill does and when to activate it, with concrete trigger phrases and named frameworks. The main gap is that it describes a single composite action rather than enumerating the specific capabilities, and the 'code examples' trigger is somewhat broad.

Suggestions

Enumerate 2-3 concrete actions in the description (e.g. 'Resolve library IDs, fetch current docs and code snippets, and cite versions') to raise specificity.

Soften or narrow the 'code examples' trigger (e.g. 'when code must match a library's current API') to reduce overlap with general code-generation skills.

DimensionReasoningScore

Specificity

The description names the domain and one composite concrete action — 'Use up-to-date library and framework docs via Context7 MCP instead of training data' — but does not enumerate the underlying capabilities (resolving library IDs, selecting matches, querying docs). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is not a 4 because no additional distinct actions are listed, and not a 2 because the tool and action are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both parts: what ('Use up-to-date library and framework docs via Context7 MCP instead of training data') and when ('Activates for setup questions, API references, code examples, or when the user names a framework'). The 'when' clause uses multiple concrete trigger phrases with examples, matching the top anchor exactly.

5 / 5

Trigger Term Quality

'Activates for setup questions, API references, code examples, or when the user names a framework (e.g. React, Next.js, Prisma)' gives good natural keyword coverage with named framework examples. It falls short of the 5 anchor because common variations such as 'documentation', 'docs', or 'up-to-date API behavior' as user-spoken phrases are only partially covered.

4 / 5

Distinctiveness Conflict Risk

Naming a specific tool (Context7 MCP) with framework-name triggers carves a clear niche with minimal conflict against unrelated skills. It is not a 5 because 'code examples' is a broad trigger that overlaps with any code-writing or documentation-fetching skill.

4 / 5

Total

16

/

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
affaan-m/ECC
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.