Content
81%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-structured, highly actionable instruction-only skill: concrete commands, exact paths, explicit quality thresholds, and validation feedback loops for a batch operation. The main improvements are removing the redundant threshold restatement in 'What NOT to do' and making the candidate-search step more concrete.
Suggestions
Consolidate the 'What NOT to do' section with the thresholds table to remove near-duplicate statements of the same criteria.
Replace Step 2's high-level search guidance with a concrete, executable search command or an explicit keyword-derivation recipe from the rule's content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with no explanations of concepts Claude already knows, but the 'What NOT to do' section almost fully restates the mandatory thresholds table ('Do not add packages with <10k weekly downloads', 'Do not add packages last published >18 months ago'), which could be trimmed. | 4 / 5 |
Actionability | Provides executable curl/jq commands with exact registry endpoints, exact rule file paths, precise frontmatter placement ('after tools: and before resources:'), and a runnable pnpm validation command; the only gap is Step 2's high-level search guidance ('Use https://www.npmjs.com/search?q={keywords} and knowledge of the ecosystem') rather than a copy-paste-ready command. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit per-candidate validation (Step 3: 'Reject any below threshold') and a post-edit feedback loop for a batch operation ('Run the validation script... If any package fails, either remove it or replace it with a better alternative'), matching the strongest anchor including error recovery. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the ~115-line single-purpose skill is organized into focused, well-signaled sections with everything appropriately inline; minor organization gaps (the duplicated threshold restatement and example section could be consolidated) keep it below the top anchor. | 4 / 5 |
Total | 17 / 20 Passed |