CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context7-mcp

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

Quality

66%

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 ./packages/opencode/skills/context7-mcp/SKILL.md

The canonical home for this skill is context7-mcp in upstash/context7

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers a clear, concrete four-step workflow for driving Context7's MCP tools, with exact tool names, parameters, and selection criteria. Its main weakness is redundancy: the Guidelines section and the opening largely restate content already covered in Steps 2 and 3, inflating token cost without adding guidance.

Suggestions

Fold the Guidelines section into the steps — "One topic per query" and "Version awareness" duplicate Step 3 and Step 2; keep only "Prefer official sources" as a Step 2 selection criterion.

Add a brief fallback in Step 2 for failed or ambiguous resolution, e.g., retry `resolve-library-id` with a more specific name or tell the user no matching documentation exists.

DimensionReasoningScore

Conciseness

There is no concept-explanation padding, but content is duplicated: Step 3's "make a separate `query-docs` call per concept with the same library ID, unless the question is about how the concepts interact" is restated nearly verbatim in the Guidelines bullet "Split multi-topic questions into separate `query-docs` calls — resolve the library ID once, then query per concept, unless...", and Step 2's "If the user mentioned a version (e.g., \"React 19\"), prefer version-specific IDs" repeats as "Version awareness". Roughly three-quarters of the Guidelines section rehashes the steps. This fits anchor 3 ("mostly efficient but... could be tightened"). Not 4 because a whole section duplicating step content is more than minor trimming; not 2 because every sentence is operational, with no fluff or explanations of things Claude already knows.

3 / 5

Actionability

The guidance is concrete and mostly executable: exact tool calls ("Call `resolve-library-id` with: `libraryName`... `query`..."), exact parameters, an example ID format ("e.g., `/vercel/next.js`"), and specific selection criteria ("Exact or closest name match", "Higher benchmark scores"). Anchor 4 ("mostly executable guidance; concrete code or commands with minor gaps") fits. Not 5 because there is no worked example invocation (a sample resolve-to-query sequence with real values) and no guidance for edge cases such as ambiguous or failed resolution; not 3 because nothing is pseudocode or vague — tool names, parameters, and decision rules are fully specified.

4 / 5

Workflow Clarity

A clear four-step sequence is present: "Step 1: Resolve the Library ID" → "Step 2: Select the Best Match" → "Step 3: Fetch the Documentation" → "Step 4: Use the Documentation", with Step 2 acting as an explicit decision checkpoint and Step 3 scoping each query "to a single concept". Anchor 4 ("clear sequence with most checkpoints present; minor validation gaps") fits. Not 5 because there is no error-recovery path (e.g., what to do when no match resolves or the docs don't answer the question); not 3 because each step's inputs, outputs, and order are explicit — the sequence is not merely listed, it is specified.

4 / 5

Progressive Disclosure

The skill is a compact single file (~52 body lines) with well-organized sections — "When to Use This Skill", "How to Fetch Documentation" with four numbered steps, and "Guidelines" — and no bundle directories (references/, scripts/, assets/) exist or are needed; all content is core workflow that appropriately lives in SKILL.md. Per the rubric's simple-skill guidance, a short skill with no need for external references scores 5 on well-organized sections alone. Not 4 because there are no organization gaps — nothing is inlined that belongs in a separate file, and navigation is trivial.

5 / 5

Total

16

/

20

Passed

Description

43%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 is trigger-rich but capability-silent: it thoroughly covers when to activate but never states what the skill does (fetch current documentation via Context7), which depresses both specificity and completeness. Distinctiveness also suffers because its unique value — up-to-date docs over training data — is never named.

Suggestions

Open with a third-person capability statement, e.g., "Fetches current library and framework documentation via Context7 for accurate API references and working code examples."

Add the natural terms "documentation" and "docs" to the trigger clause so users asking to "check the docs" or "use the latest API" match.

Mention Context7 by name so the skill is distinguishable from generic library-help or code-generation skills.

DimensionReasoningScore

Specificity

The description names its domain ("libraries, frameworks, API references, or needs code examples") but states no concrete skill action — it never says the skill fetches current documentation via Context7; every clause ("should be used when the user asks about..." and "Activates for setup questions...") describes triggers, not capabilities. This matches anchor 2 ("Names the domain but actions are minimal or generic"). Not 3, which requires 1-2 concrete capability actions (e.g., "fetches documentation, retrieves code examples"), and none appear; not 1 because the domain is specifically named rather than pure abstraction.

2 / 5

Completeness

The 'when' is explicit and detailed ("should be used when the user asks about libraries... or needs code examples", "Activates for setup questions..."), but the 'what' is entirely absent — the description never states any capability, so per the guideline to score only what is explicitly stated, no 'what' exists. This matches anchor 2's second branch ("only 'when' is present without 'what'"). Not 3, which requires a clear 'what'; not 1 because the 'when' is present and specific.

2 / 5

Trigger Term Quality

Good natural keyword coverage: "libraries, frameworks, API references", "setup questions, code generation involving libraries", plus named frameworks "React, Vue, Next.js, Prisma, Supabase" — phrases users would naturally say. However, the core natural terms "documentation" and "docs" are absent, so it falls short of anchor 5's "comprehensive coverage... including synonyms". Not 3 because coverage clearly exceeds "some relevant keywords" — it spans multiple trigger categories with concrete framework names.

4 / 5

Distinctiveness Conflict Risk

Broad triggers like "needs code examples", "setup questions", and "code generation involving libraries" overlap with any framework-specific or code-generation skill, but the API-reference focus and named frameworks ("React, Vue, Next.js, Prisma, Supabase") give it moderate specificity. Anchor 3 ("Somewhat specific but could still overlap with similar skills") fits. Not 4 because without mentioning Context7 or documentation retrieval the overlap risk is more than minor; not 2 because it is well beyond "very broad" generics like "helps with document files".

3 / 5

Total

11

/

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

upstash/context7

Path

packages/opencode/skills/context7-mcp/SKILL.md

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.