Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with concrete, actionable guidance and a clear gated workflow, but it carries some redundancy and keeps reference-style content inline in a single monolithic file.
Suggestions
De-duplicate: remove the repeated intro line and merge the 'When to Use This Skill' section into the Trigger section.
Move the Search Shortcuts category tables and worked Examples into a separate references file, keeping SKILL.md a concise overview with one-level-deep links.
Tighten the Quick Mode list so it does not restate steps already shown in the workflow diagram.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (no explanations of what npm/PyPI/MCP are) and uses efficient lookup tables, but repeats the frontmatter intro and re-states the Trigger list in a separate 'When to Use' section, so it could be tightened. | 2 / 3 |
Actionability | Provides concrete, runnable guidance: named packages per category, exact search queries, a fill-in subagent prompt template, a signal-to-action decision matrix, and worked examples with specific packages and scores. As an instruction skill this meets the actionable bar. | 3 / 3 |
Workflow Clarity | A clearly sequenced 5-step pipeline (Need → Parallel Search → Evaluate → Decide → Approval Checkpoint/Implement) with an explicit approval gate before any write action and a decision matrix that branches on evaluation signals. | 3 / 3 |
Progressive Disclosure | No bundle files exist, so there are no nested references; sections are well-organized and single-level. But the skill exceeds the simple-skill line count and keeps long examples and category shortcut tables inline rather than splitting them into reference files. | 2 / 3 |
Total | 10 / 12 Passed |