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.
A well-structured, highly actionable single-file skill with an explicit step sequence and guardrails. Its weaknesses are redundancy — tool definitions and step instructions repeated across Core Concepts, Steps, Examples, and Best Practices — and a missing recovery path when library resolution fails or returns ambiguous results.
Suggestions
Merge 'Core Concepts' into Steps 1 and 3 so each tool is defined once alongside its parameters, cutting the double explanation.
Reduce the three near-identical Examples to one fully worked example plus a one-line table of variations (Prisma, Supabase), or keep the differing details only.
Add an error-recovery step: what to do when resolve-library-id returns no match or multiple plausible IDs (retry with a refined query, or ask the user which library they mean).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but contains noticeable redundancy: 'Core Concepts' re-explains resolve-library-id and query-docs that Steps 1 and 3 then restate with their parameters, the three Examples each replay the identical 4-step flow, and 'Best Practices' repeats guidance already in Step 2 ('Version awareness', 'Be specific'). It fits the 'could be tightened' anchor rather than the 'minor instances of over-explanation' anchor because whole sections overlap, not just sentences. Nothing explains concepts Claude already knows, which keeps it above 2. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact tool names, exact parameters (libraryName, query, libraryId), the library-ID format ('/org/project'), selection criteria, a hard 3-call limit with an explicit fallback behavior, and three fully worked call sequences. This matches 'concrete, specific guidance' at the top anchor; there are no pseudocode or vague steps. | 5 / 5 |
Workflow Clarity | The 4-step sequence (resolve → select → query → use) is clearly ordered with an explicit precondition ('You must obtain a Context7-compatible library ID before querying docs') and a termination guardrail (3-call limit with 'state the uncertainty'). It is not 5 because there is no error-recovery loop for the main failure mode — resolve-library-id returning no match or an ambiguous list — beyond the generic call limit. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; the single-file body is well organized into When to use / How it works / Examples / Best Practices with no monolithic inlined reference material. It is not 5 because the body (~82 lines) exceeds the simple-skill threshold and the redundant Examples section is content that could be consolidated or split, leaving minor organization gaps. | 4 / 5 |
Total | 16 / 20 Passed |