Content
93%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.
An exemplary short skill body: lean, concrete, and well-structured, with precise tool-call guidance and a sensible auth-error recovery path. The only gap is the absence of fallback guidance when library resolution or doc queries return poor results.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its tokens: the intro names the two tools in one sentence, the workflow gives concrete selection criteria, and constraints are compact limits. There is no explanation of concepts Claude already knows (no primer on what documentation or MCP tools are) and no padded prose. This matches the 'Lean and efficient; every token earns its place' anchor rather than the 4 anchor's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Guidance is fully executable: it names both tools ("resolve-library-id", "query-docs"), their inputs ("the library name and what to look up"), the output shape ("Context7 IDs (/org/project format), descriptions, snippet counts, and quality scores"), selection criteria, the skip rule for pre-supplied IDs, the per-concept query scoping rule, the literal "`query` argument" for the data-safety constraint, and the "CONTEXT7_API_KEY" env var with a recovery URL. Per the rubric's instruction-skill note, absence of literal code is not penalized when guidance is this concrete, so it meets the top anchor. | 5 / 5 |
Workflow Clarity | The three steps are clearly numbered and sequenced, with decision rules (selection criteria for step 1, per-concept query splitting, the skip rule) and an error-recovery path ("if requests fail with an auth error" → get a key). However, there are minor validation gaps — no guidance for a no-match or low-quality result from resolve-library-id, or for handling empty/irrelevant query-docs results — which matches the 4 anchor ('most checkpoints present; minor validation gaps') rather than the fully checkpointed anchor 5. This is a read-only lookup, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | The skill has no bundle files (references/, scripts/, assets/ are absent) and the body is ~26 lines with well-organized sections (When to use, Workflow, Constraints). Per the rubric guideline that skills under 50 lines needing no external references can score 5 with well-organized sections, this matches the top anchor; there is no inlined content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |