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).

65

Quality

79%

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

The body is a well-structured, highly actionable guide to the Context7 MCP workflow with exact tool names, parameters, and selection criteria. Its main weakness is redundancy — the When-to-use section and the three examples largely repeat the description and the four steps — which inflates token cost without adding guidance.

Suggestions

Trim redundancy: drop or merge the 'When to use' section with the description content, and state 'always call resolve-library-id first' only once (Step 1) instead of repeating it in Core Concepts.

Consolidate the three Examples into one worked example (e.g., Next.js middleware), since each currently restates the same four steps already detailed in 'How it works'.

Add brief failure-path guidance in the workflow: what to do when resolve-library-id returns no results or several ambiguous matches, complementing the existing 3-call limit.

DimensionReasoningScore

Conciseness

The body is mostly efficient — Core Concepts and the step parameters are genuinely new information (MCP tool semantics Claude cannot know) — but there is noticeable repetition: the "When to use" section restates the description, "Always call resolve-library-id first" is repeated in Step 1, and the three worked examples largely restate the four steps. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is above 2 because there is no padding about concepts Claude already knows, and below 4 because the redundancy is real, not minor.

3 / 5

Actionability

The guidance is fully executable: exact MCP tool names (resolve-library-id, query-docs), exact parameters with concrete values (libraryName: "Next.js", libraryId: "/vercel/next.js"), explicit selection criteria (name match, benchmark score, reputation, version), and a hard call limit of 3 with a fallback. Per the rubric's code-vs-instruction note, an instruction-only skill with guidance this specific earns the top anchor.

5 / 5

Workflow Clarity

The four-step sequence (resolve → select best match → query docs → use) is clearly ordered, with selection criteria acting as a checkpoint and the 3-call limit plus 'state the uncertainty' acting as an error-recovery fallback. It is not 5 because there is no guidance for failure paths such as resolve returning no results or an ambiguous match; it is above 3 because checkpoints are present, not just implicit.

4 / 5

Progressive Disclosure

The single file is well organized into clearly signaled sections (Core Concepts, When to use, How it works, Examples, Best Practices) with no buried or nested references, and no bundle files exist that should be linked. It matches 'Good structure; most content is appropriately placed; minor organization gaps' — the three near-duplicate examples could be consolidated or moved to a reference file, keeping it below the lean, cleanly split top anchor.

4 / 5

Total

16

/

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: it clearly states what the skill does, via which mechanism, and when to activate it, with concrete example frameworks. Main gaps are a single generic core action ("use docs") and a few missing natural trigger synonyms like "documentation" or version-related phrasing.

DimensionReasoningScore

Specificity

The description names the domain ("library and framework docs"), the concrete mechanism ("via Context7 MCP instead of training data"), and several specific activation contexts ("setup questions, API references, code examples"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because the core capability is a single action (fetch docs) and the two underlying tools are not named; it is above 3 because it goes well beyond naming the domain with one generic action.

4 / 5

Completeness

It explicitly answers both 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") with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Natural phrases like "setup questions", "API references", "code examples", and concrete framework names ("React, Next.js, Prisma") give good keyword coverage per the anchor 'Good keyword coverage; a few natural terms missing'. It is not 5 because common variations users would say — "documentation", "latest version", "how to use X", file formats — are absent.

4 / 5

Distinctiveness Conflict Risk

The Context7 MCP niche with framework-name triggers is mostly distinct, matching 'Mostly distinct; minor overlap risk'. It is not 5 because broad triggers like "code examples" could plausibly fire for general coding skills where training data suffices; it is clearly above 3 since the niche is well-defined and unlikely to collide with unrelated skills.

4 / 5

Total

17

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

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.