Content
71%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 delivers a clear, actionable four-step workflow with concrete tool names and parameters, and is appropriately structured for a compact single-purpose skill. Its main weakness is redundancy: the query-splitting rule and version-preference guidance are each repeated, and the trigger section duplicates the frontmatter.
Suggestions
State the one-topic-per-query rule once (in Step 3) and drop the duplicate "Be specific" and "One topic per query" guideline bullets.
Merge the Step 2 version-preference bullet with the "Version awareness" guideline so it appears only once.
Remove or shrink the "When to Use This Skill" section, which restates the frontmatter description verbatim in substance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient procedural instruction, but the one-topic-per-query rule is stated three times ("scoped to a single concept", "keep each query to a single concept", "One topic per query: Split multi-topic questions"), version preference appears twice (Step 2 and "Version awareness"), and the "When to Use This Skill" section duplicates the frontmatter description. This fits anchor 3 ('mostly efficient but could be tightened') rather than 2, since there is no conceptual padding or explanation of things Claude already knows. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: named tools ("Call `resolve-library-id` with", "Call `query-docs` with"), their exact parameters ("libraryName", "query", "libraryId"), and an example library ID ("/vercel/next.js"). It falls short of anchor 5 only in lacking a literal worked example of a call, e.g., resolving and querying Next.js proxy configuration end-to-end. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (resolve library ID → select best match → fetch docs → use docs) with explicit selection criteria in Step 2 (name match, benchmark scores, version preference). It misses anchor 5 because there are no error-recovery feedback loops for failure cases, such as what to do when resolution returns no match or ambiguous results. | 4 / 5 |
Progressive Disclosure | This is a short, single-purpose skill with no external references needed, and the body is organized into clear, well-labeled sections (When to Use, How to Fetch Documentation with four sub-steps, Guidelines). Per the simple-skill guidance, well-organized sections alone warrant a 5 here. | 5 / 5 |
Total | 16 / 20 Passed |