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

64%

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 ./plugins/codex/context7/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 crisp, executable four-step workflow for the Context7 MCP tools with concrete parameters and good edge guidance on multi-concept queries. Its main weakness is redundancy — the Guidelines section and When-to-Use list restate earlier content — which costs tokens without adding guidance. Structure and actionability are solid.

Suggestions

Deduplicate: drop the 'One topic per query' and 'Be specific' Guidelines items (they restate Step 3's multi-concept paragraph) and fold the version-awareness bullet into Step 2, where version-specific IDs are already introduced.

Add one concrete example invocation (resolve-library-id → query-docs round trip with a real library ID) to make the guidance copy-paste ready, plus a fallback when resolution returns no good match.

DimensionReasoningScore

Conciseness

Mostly efficient, but there is real duplication: the "When to Use This Skill" bullet list restates the opening line almost verbatim, and the Guidelines item "One topic per query: Split multi-topic questions into separate query-docs calls... unless the question is about how the concepts interact" repeats Step 3's multi-concept paragraph word-for-word. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 2 because there is no concept-explanation padding (nothing teaches what a library or MCP is), and not a 4 because the duplicated sections are noticeable, not minor.

3 / 5

Actionability

Concrete, executable guidance: exact tool names with parameters ("Call `resolve-library-id` with: `libraryName`, `query`"; "Call `query-docs` with: `libraryId`, `query`"), an example ID format ("/vercel/next.js"), and explicit match-selection criteria. Minor gaps keep it at 4 rather than 5: no example invocation payloads or sample responses, and no guidance for the no-match/ambiguous-match case.

4 / 5

Workflow Clarity

A clear four-step sequence (resolve library ID → select best match → fetch docs → use docs) with decision criteria at each step (exact match, benchmark scores, version-specific IDs, one-concept-per-query). Minor validation gaps — e.g., what to do when resolution returns no good match — hold it at 4 rather than 5; it is well above a 3 because the sequence is unambiguous with explicit selection checkpoints, and this read-only lookup involves no destructive or batch operations requiring feedback loops.

4 / 5

Progressive Disclosure

A compact single-file skill (~40 non-blank body lines) with no references/, scripts/, or assets/ bundle and no content that belongs in separate files, organized under clean headers (When to Use / How to Fetch Documentation / Guidelines). Per the rubric's small-skill allowance, well-organized sections with no need for external references score 5; nothing is inlined that should be split out and navigation is trivial.

5 / 5

Total

16

/

20

Passed

Description

40%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 has strong, natural trigger coverage but never states what the skill actually does — a reader cannot tell it fetches current documentation via Context7's resolve-library-id/query-docs tools. Its triggers are also broad enough to collide with general coding skills. Overall a below-midpoint description: excellent 'when', missing 'what'.

Suggestions

Lead with a concrete 'what' clause, e.g. "Fetches up-to-date library/framework documentation via Context7 MCP tools (resolve-library-id, query-docs) instead of relying on training data", so the description answers both what and when.

Narrow the activation triggers from "code generation involving libraries" to documentation-shaped requests (API references, setup/config questions, version-specific behavior) to reduce conflict with general coding and framework-specific skills.

Add natural synonyms users say when they need docs: "documentation", "docs", "SDK", "how to use X in Y".

DimensionReasoningScore

Specificity

The description names its domain clearly ("libraries, frameworks, API references, or needs code examples") but states no concrete actions at all — nothing like "fetches current documentation" or "retrieves API references". It matches the anchor 'names the domain but actions are minimal or generic' (here, absent) rather than score 1, since it is not pure abstract language, and not score 3, since no 1-2 concrete actions are actually listed.

2 / 5

Completeness

Only the 'when' is present: "Activates for setup questions, code generation involving libraries, or mentions of specific frameworks". The 'what' — that the skill fetches current library documentation via Context7 — is entirely absent, matching the score-2 anchor 'only when is present without what' ("Use when working with documents"-style). It cannot be a 3 because the 'what' is not weakly implied; it is missing, and the skill's actual mechanism (Context7 MCP tools) is never named.

2 / 5

Trigger Term Quality

Good natural keyword coverage: "setup questions", "code generation", "API references", and concrete framework names ("React, Vue, Next.js, Prisma, Supabase") that users would actually say. A few natural terms are missing ("docs", "documentation", "SDK", "how to use X"), so it falls short of the comprehensive-with-synonyms anchor at 5 but is well above the 'some relevant keywords' level of 3.

4 / 5

Distinctiveness Conflict Risk

Triggers like "code generation involving libraries" and "needs code examples" fire on almost any modern coding request, creating high overlap risk with general coding and framework-specific skills. This matches the anchor 'very broad; high overlap risk with many similar skills'; it is not a 3 because the overlap is not limited to closely-related skills, and not a 1 because the framework names and API-reference focus provide some specificity.

2 / 5

Total

10

/

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

plugins/codex/context7/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.