Content
85%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.
Highly actionable, clearly sequenced, and well-structured progressive disclosure with verified bundle references. The main cost is token efficiency: several sections repeat guidance or stats that appear elsewhere in the skill.
Suggestions
Remove the opening line that restates the frontmatter's data-catalog statistics (80 styles, 192 palettes, etc.) verbatim, or keep only one of the two.
Merge the 'If a search returns 0 results' section into the Query Contract's retry guidance (or vice versa) and drop the overlapping bullets in 'Tips for Better Results' — the retry-once rule and 2–5-term guidance are currently stated three times.
State the full script path once (e.g. define it as a single command template or variable) instead of repeating the entire ${CLAUDE_PLUGIN_ROOT}/... invocation in every code block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational, but it duplicates the frontmatter's data-catalog statistics verbatim in the opening line, states the retry-once/empty-result protocol twice (Query Contract and the 'If a search returns 0 results' section), restates query-contract bullets in 'Tips for Better Results', and repeats the full script path in every code block. This is more than minor trimming, matching 'mostly efficient but could be tightened' rather than the efficient 4 anchor. | 3 / 5 |
Actionability | Fully executable throughout: exact copy-paste commands with all flags (--design-system, --domain, --stack, --rtl, --persist, --output-dir, the three design dials), a per-domain example-query table, and a worked end-to-end example workflow for a detected Next.js project. | 5 / 5 |
Workflow Clarity | Steps 1→4 are explicitly sequenced with a required gate for new pages (Step 2 REQUIRED), result verification before applying ('Verify the returned domain/category, top result identity, and fit'), an explicit retry-then-fallback feedback loop for empty or off-topic results, and safe-persistence checks (read existing MASTER.md, never --force without user authorization). | 5 / 5 |
Progressive Disclosure | A clear overview with well-signaled one-level-deep references: references/quick-reference.md and references/pro-rules.md (both verified present) are each introduced with their purpose and an on-demand loading instruction, the priority table stays as a compact overview, and the Tips table links to specific quick-reference sections (§5–§9). | 5 / 5 |
Total | 18 / 20 Passed |