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 well-structured, highly actionable single-file skill: concrete CLI commands, a clearly sequenced six-step workflow with a quality-verification checkpoint, and good handling of edge cases like no search results. Minor improvements are possible by trimming conceptual explanations, merging the tips/categories sections, and adding post-install verification.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — concrete commands, short steps, and example responses with little padding. It falls short of level 5 because of a few sentences explaining what the ecosystem/CLI is ("Skills are modular packages that extend agent capabilities...") that Claude could infer, and the Tips section partially duplicates the categories table. It is well above level 3, where unnecessary explanation would be more prevalent. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: full commands (`npx skills find [query] [--owner <owner>]`, `npx skills add <owner/repo@skill> -g -y`), worked query-to-command examples ("how do I make my React app faster?" → `npx skills find react performance`), and a template response for presenting options. It also covers the no-results case, matching the level 5 anchor of executable commands with examples covering common cases. | 5 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced and includes an explicit checkpoint — Step 4 "Verify Quality Before Recommending" with concrete criteria (install count, source reputation, stars) before anything is presented or installed. It is not level 5 because there is no post-install verification (e.g., confirming the skill actually installed successfully) and no error-recovery loop for failed installs or searches. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so this is a single-file skill; the body is well-organized with clear section headers (When to Use, CLI commands, six-step process, categories, fallback). It is not level 5 because at ~135 lines the categories table and search tips could be condensed or merged, leaving minor organization gaps rather than the fully earned-place-per-token structure of the top anchor. | 4 / 5 |
Total | 17 / 20 Passed |