CtrlK
BlogDocsLog inGet started
Tessl Logo

context7-docs-research

Resolve the correct library and retrieve a small, relevant set of version-aware official documentation before answering a technical question.

58

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./examples/plugin-packages/context7/skills/context7-docs-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 an exemplary model of token efficiency — a tight five-step workflow with a clear guardrail against version mixing and undocumented claims. Its one real gap is actionability: it never says how to perform the retrieval (no Context7 tool names, example queries, or output-handling commands), leaving the reader to infer the mechanics. Adding a short concrete example of resolving a library and querying its docs would close that gap.

Suggestions

Add a brief concrete example of the core operation — e.g., the actual Context7 tool call or query used to resolve a library name and fetch version-matched docs.

Include one or two natural documentation queries (e.g., "How do I migrate from react-router v5 to v6?") to make step 3's "focused documentation questions" executable.

Add an explicit verification step between retrieval and answering: confirm the retrieved documentation's version matches the installed version before relying on it.

DimensionReasoningScore

Conciseness

The 8-line body is lean with zero padding: a numbered workflow plus one constraint line ("Do not mix examples from incompatible major versions or claim undocumented behavior as guaranteed"), assuming Claude's competence with no concept explanations. It matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place' rather than score 4, which would require trimmable over-explanation — none is present.

5 / 5

Actionability

The steps give behavioral direction ("Prefer API references, migration guides, and official examples", "keep retrieved context bounded") but omit the execution mechanics — no Context7 tool names, example queries, or concrete commands showing how to resolve a library or retrieve docs. This matches 'some concrete guidance but incomplete... missing key details'; it is above score 2 because the directives are specific instructions rather than high-level hints, but below score 4 because a reader cannot execute the workflow without guessing the actual tool invocations.

3 / 5

Workflow Clarity

Steps 1-5 form a clear, ordered sequence (identify → resolve → query bounded → prefer version-matched sources → explain with provenance), which matches 'clear sequence with most checkpoints present'. It is not score 5 because there is no explicit validation checkpoint (e.g., verifying retrieved docs match the installed version before answering), only the implicit guard in step 5's "distinguish documentation from inference"; the skill is read-only, so the destructive-operation cap at 3 does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and the content is well-organized (numbered workflow followed by a clearly separated caution line), so per the rubric's simple-skill guidance progressive disclosure scores 5. No bundle files exist and no references are cited, so there are no buried or nested references to penalize.

5 / 5

Total

17

/

20

Passed

Description

53%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 concise, in third person, and free of fluff, clearly stating what the skill does. Its main weaknesses are the absent explicit 'Use when...' trigger clause and thin coverage of natural trigger terms users would actually say. Adding trigger phrasing and a couple of synonyms would lift completeness and trigger-term quality.

Suggestions

Append an explicit trigger clause such as "Use when answering technical questions about a library's API, migration, or version-specific behavior, or when the user mentions needing current docs."

Include natural trigger synonyms users would say — e.g., "docs", "API reference", "up-to-date documentation" — to improve trigger term coverage.

Name Context7 (or the retrieval mechanism) in the description to sharpen distinctiveness against generic web-search skills.

DimensionReasoningScore

Specificity

The description names two concrete actions — "Resolve the correct library" and "retrieve a small, relevant set of version-aware official documentation" — matching the anchor for 1-2 concrete actions without comprehensive coverage. It is not score 4 because it does not list several specific actions (e.g., no mention of querying, filtering, or citing docs), and not score 2 because the actions are specific rather than generic domain labels.

3 / 5

Completeness

The 'what' is clear (resolve library, retrieve bounded version-aware documentation), but there is no explicit 'Use when...' trigger clause; "before answering a technical question" only weakly implies when. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3, and it cannot score 4 since the 'when' is not explicit.

3 / 5

Trigger Term Quality

Relevant keywords like "library", "official documentation", and "version-aware" are present, but common natural variations users would say — "docs", "API reference", "up-to-date documentation", "context7" — are missing. This matches the anchor 'some relevant keywords but missing common variations or synonyms', not score 4 which requires only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The niche — resolving library identity and retrieving version-matched official documentation — is mostly distinct with only minor overlap risk against generic web-search or research skills. It is not score 5 because the description never names Context7 or a unique trigger that would eliminate overlap with other documentation-retrieval skills.

4 / 5

Total

13

/

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
Devin-AXIS/iPolloWork
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.