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

67

Quality

80%

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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-built, highly actionable MCP-workflow skill: exact tool calls with concrete parameter values, a hard call budget, security redaction guidance, and three worked examples. Its weaknesses are minor — slight redundancy between the Core Concepts and Steps sections, and no recovery path for edge cases like an empty resolve-library-id result.

Suggestions

Merge the Core Concepts bullets for 'resolve-library-id' and 'query-docs' into Steps 1 and 3 to remove the duplicated definitions and tighten token usage.

Add a brief recovery branch for Step 1, e.g. 'If resolve-library-id returns no close match, retry once with a more specific library name; if still empty, answer from training data and say so' — this would give the workflow an explicit feedback loop.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence (no explanation of what libraries or documentation are), and every section carries operational content. Minor duplication keeps it from 5: the Core Concepts bullet definitions of 'resolve-library-id' and 'query-docs' restate information given again in Steps 1 and 3, and could be merged.

4 / 5

Actionability

Fully concrete, executable guidance: exact MCP tool names, exact parameter names and values ('libraryName: "Next.js"', 'libraryId: "/vercel/next.js"'), selection criteria, a hard 3-call limit, and three worked examples covering common cases (Next.js, Prisma, Supabase). This is copy-paste-ready instruction of the kind the score-5 anchor describes.

5 / 5

Workflow Clarity

A clear four-step sequence with an explicit gate ('Do not call query-docs without a valid library ID'), selection criteria as a checkpoint, and a fallback when the answer stays unclear after 3 calls. Not 5: there is no true feedback/recovery loop — e.g. what to do when resolve-library-id returns no usable match is unaddressed — and no explicit verification that fetched snippets actually answer the question.

4 / 5

Progressive Disclosure

The skill is a single self-contained SKILL.md with no references/, scripts/, or assets/ bundle, and nothing in it clearly belongs in a separate file; headers (Core Concepts, When to use, How it works, Examples, Best Practices) make navigation easy. Not 5: the body runs ~84 lines (above the under-50-line simple-skill exception), and Core Concepts/Examples sections could arguably be split out if the skill grows.

4 / 5

Total

17

/

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 explicitly states both what the skill does and when it activates, with concrete framework examples as triggers. Its main weakness is that the 'what' side lists only a single action, and a few natural trigger phrases (e.g. 'documentation', 'latest version') are absent.

Suggestions

Expand the 'what' clause from a single action to 2-3 concrete capabilities, e.g. 'Resolves library IDs, fetches current API docs and code examples, and cites versions' — this would raise specificity from 3 to 4-5.

Add a few more natural trigger phrases users would actually say, such as 'latest documentation', 'up-to-date API reference', or 'which version of X supports Y'.

DimensionReasoningScore

Specificity

The description names the domain ("library and framework docs") and one concrete action ("Use up-to-date... docs via Context7 MCP instead of training data") with a specific mechanism, but does not list multiple distinct actions like the score-4/5 anchors ('Extracts text, fills forms, converts pages'). Not score 2, because the action named is concrete and tool-specific rather than generic ('Processes PDF files').

3 / 5

Completeness

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"), matching the score-5 anchor's structure of concrete 'what' plus explicit trigger phrases.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "setup questions, API references, code examples" plus concrete framework names ("React, Next.js, Prisma") that users would naturally say. Not 5, because common variations like 'documentation', 'latest docs', or '.docs' style phrasings and additional library names are missing; not 3, since several natural trigger phrases beyond the domain noun are present.

4 / 5

Distinctiveness Conflict Risk

The Context7 MCP niche is clear and the triggers are fairly distinct, but broad triggers like "code examples" and "API references" could overlap with general web-research or API-reference skills. Mostly distinct with minor overlap risk — the score-4 anchor; the score-5 anchor requires minimal conflict risk across the full trigger set.

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
ysyecust/everything-claude-code
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.