Content
86%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 tight, highly actionable instruction skill: exact commands and tool names, a clear five-step sequence with a call budget and error handling, and no padding. The only refinements are consolidating transport guidance and adding a retry path for weak library matches.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows — sections are pure operational guidance ("Use no more than three Context7 resolution or documentation calls per question", "Do not send API keys, passwords, credentials, or other secrets"). It is not a 5 because transport guidance is split between Step 1 ("Prefer the Context7 MCP tools...") and Step 5 ("Keep one transport for the question..."), a minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Guidance is fully executable: exact MCP tool names with arguments ("resolve-library-id", "query-docs") and copy-paste CLI commands ("npx ctx7@latest library <name> \"<user's question>\"", "npx ctx7@latest docs <libraryId> ..."), plus concrete failure handling ("npx ctx7@latest login or CONTEXT7_API_KEY"). This matches anchor 5's copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with a call budget, explicit error recovery for quota failures, and an uncertainty fallback ("state the uncertainty instead of guessing"). It falls short of anchor 5 because there is no feedback loop for a poor library match (e.g., re-resolving with a refined query) — checkpoints exist but the retry path is only implied by the call limit. | 4 / 5 |
Progressive Disclosure | The skill is a compact single-purpose workflow (~56 lines) with well-organized sections (When to Use, Workflow steps) and no bundle files; nothing here warrants splitting into references. Per the simple-skill guidance, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 18 / 20 Passed |