Content
78%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, actionable workflow that names the real tools and parameters and sequences the steps clearly, with only minor redundancy and missing failure-handling guidance. Progressive disclosure is fully appropriate for a self-contained skill of this size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it never explains what libraries or documentation are — but the trigger list is duplicated across the intro and 'When to Use This Skill', and the one-topic-per-query rule is restated in Guidelines, giving minor instances that could be trimmed; not a 5 because of that structural repetition. | 4 / 5 |
Actionability | Concrete, executable guidance names the actual MCP tools (`resolve-library-id`, `query-docs`) with their parameters (`libraryName`, `query`, `libraryId`) and an example ID (`/vercel/next.js`); falls short of 5 because no full invocation example or exact call syntax is shown, leaving a minor gap. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (Resolve → Select → Fetch → Use) with a branching decision point for multi-concept questions; not a 5 because there are no error-recovery feedback loops (e.g., what to do when resolve returns no good match or query-docs returns irrelevant results), though this is a read-only operation so the gap is minor. | 4 / 5 |
Progressive Disclosure | The skill is self-contained (no bundle files exist), roughly 50 lines, with clean section headers (When to Use, How to Fetch Documentation, Guidelines) and no nested references; per the simple-skill guideline, a short self-contained skill with well-organized sections scores 5. | 5 / 5 |
Total | 17 / 20 Passed |