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.
A well-organized, token-efficient rule index that defers detail to per-rule files as progressive disclosure intends. The main gaps are the unverified/missing bundle files behind its references and the absence of any stated process for how to traverse the rules when working on a task.
Suggestions
Ensure the referenced bundle actually ships with the skill (rules/ directory and AGENTS.md), or inline the handful of CRITICAL rules' key examples so the skill remains actionable when the files are absent.
Add a short 'How to apply' sequence: identify the task type (data fetching, rendering, bundle), look up the matching category by priority tier, then open the specific rule file — replacing the duplicated 'When to Apply' section that restates the description.
Drop the priority table or the per-category Quick Reference headers (they restate the same category/impact data) and expand too-terse entries like 'better-all' with a path to the relevant rule file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean rule index: 62 rules as one-line name-plus-directive pairs ('async-parallel - Use Promise.all() for independent operations') with no padding or explanation of concepts Claude already knows. It falls short of anchor 5 because the priority table repeats the category/impact data that the Quick Reference section headers restate, and the 'When to Apply' section partially duplicates the frontmatter description. | 4 / 5 |
Actionability | Most rules are immediately actionable directives with named APIs ('Use React.cache() for per-request deduplication', 'Use next/dynamic for heavy components', 'Use toSorted() for immutability'). As an index it deliberately defers detail to rule files, which is fine per the instruction-skill note, but a few entries are too terse to act on without reading the referenced file ('Use better-all for partial dependencies' names an unfamiliar library with no pointer), keeping it below anchor 5. | 4 / 5 |
Workflow Clarity | As a single-purpose reference skill, the single action (consult rules by category, prioritized by the impact table) is unambiguous, and the 'How to Use' section explains the structure of each rule file with example paths. It misses anchor 5 because there is no stated sequence for applying the guide — e.g., whether to scan by priority tier or match rules to the task at hand — which the rubric reserves for skills with explicit sequenced workflows. | 4 / 5 |
Progressive Disclosure | Structure is promising — an index body with one-level-deep, clearly signaled references ('rules/async-parallel.md', 'AGENTS.md') — but no bundle files exist alongside SKILL.md (no rules/ directory, references/, scripts/, or assets/), so the referenced paths cannot be verified and may not resolve. Per the guideline to score against the actual bundle structure, references that point at files not present in the bundle sit at anchor 3: structure present but not reliably navigable, and the inline 62-rule catalog does some of the work a real reference file should carry. | 3 / 5 |
Total | 15 / 20 Passed |