Content
82%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 highly actionable, well-sequenced workflow skill with concrete tool calls, quality gates, and a security-aware install path. Its main gaps are mild repetition of the shell-out warning, no error-recovery guidance for failed searches or installs, and inlined reference-style content that could be split out.
Suggestions
Add an error-recovery branch for install failures or empty search results (e.g. retry with broader keywords, suggest the skills.sh browse fallback) to close the workflow feedback loop.
State the 'do not shell out to npx skills / git' rule once and reference it from Step 6 rather than repeating the full rationale twice.
Move the Common Skill Categories table and the sample response templates into a reference file (e.g. references/examples.md) to slim the main SKILL.md body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and does not explain concepts Claude already knows, but the 'do NOT shell out to npx skills, git, or any package manager' warning is repeated in both 'The skill tools' and Step 6, and the example response blocks run long. This matches anchor 4 (minor trimmable over-explanation) rather than 3 (no real padding) or 5 (every token earns its place). | 4 / 5 |
Actionability | Guidance is fully executable: copy-ready tool calls like search_skills("react performance") and install_skill("claude-plugins:vercel-labs/agent-skills/skills/react-best-practices"), concrete quality thresholds (prefer 1K+ installs, skeptical below 100 stars), and a covered no-results fallback path with example response text. | 5 / 5 |
Workflow Clarity | The six steps are clearly sequenced with real checkpoints (Step 4 quality verification, Step 6 security warning, review link, and explicit install-intent gate). It falls short of anchor 5 only because there is no error-recovery feedback loop, e.g. what to do when a search returns nothing relevant or an install fails. | 4 / 5 |
Progressive Disclosure | The single file is well-organized with clear section headers and no buried references (no bundle files exist), but at ~150 lines the Common Skill Categories table, search tips, and example responses are inlined content that could live in a reference file. The skill exceeds the under-50-line simple-skill exception, so anchor 5 does not apply; structure is solid, matching anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |