Content
71%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, lean instructional skill body with concrete executable commands and a clearly sequenced workflow. The two real weaknesses are the missing feedback/validation guidance in the workflow and a dangling bundle reference (`data/ui-reasoning.csv` is cited and loaded by `search.py` but absent), which also breaks every documented command at runtime.
Suggestions
Fix the dangling reference: ship `data/ui-reasoning.csv` in the bundle or remove it from the References section — as written, every `search.py` invocation in the skill fails at `load_rules`.
Consolidate the two near-duplicate `--persist` examples in step 2, and show a short sample of the script's output so the step-5 synthesis has a concrete input to work from.
Add error-recovery guidance to the workflow, e.g. what to do when a domain/stack search returns no matches (fall back to `--design-system` output, ask the user, or proceed with defaults).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — no explanations of concepts Claude already knows, and domains/stacks are given as terse enumerations. Minor trims exist: the two `--persist` example commands near-duplicate each other, and the Role/"not a replacement" framing slightly restates the opening. This fits "efficient; minor instances of over-explanation that could be trimmed" rather than the lean-every-token-earns-its-place 5. | 4 / 5 |
Actionability | Guidance is concrete and mostly executable: full `python3 .../search.py` invocations with literal example queries ("glassmorphism dark", "real-time dashboard") and verified flags. It falls short of fully copy-paste-ready because step 2's primary command uses placeholder arguments ("<product_type> <industry> <keywords>", "Project Name") and no sample output of the script is shown, leaving minor gaps per the 4 anchor. | 4 / 5 |
Workflow Clarity | A clear five-step numbered sequence with the concrete command at each step, plus an explicit fallback default ("If the user does not specify a stack, default to `html-tailwind`") and a post-gathering synthesis step. However, there are no validation checkpoints or error-recovery loops (e.g., what to do if a search returns nothing), which caps it at the 4 anchor rather than 5. The operations are non-destructive lookups, so the destructive-operation cap at 3 does not apply. | 4 / 5 |
Progressive Disclosure | The structure is good — a short overview with a References section signaling what to load when, and one-level-deep references — but scored against the actual bundle, the referenced `data/ui-reasoning.csv` does not exist in the bundle (only `references/USAGE.md` and `scripts/search.py` are present, and `search.py` loads that CSV at runtime), so a advertised reference is dangling. This places it at the 3 anchor: structure present with real organization gaps, below the 4 anchor's "references mostly clear" with only minor issues. | 3 / 5 |
Total | 15 / 20 Passed |