Content
75%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |