Content
65%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.
The body is a strong, actionable reference with concrete code and a useful anti-patterns table. It loses points because it poses as a multi-file skill (`@rules/*.md`, `Key Files`) without shipping those files, and as a reference it has no sequenced workflow.
Suggestions
Ship the referenced `@rules/*.md` files under a `references/` (or `rules/`) bundle directory, or drop the `@rules/...` pointers and keep the rules inline so links aren't broken.
Add a short "How to apply" sequence (identify the relevant domain → pick the rule → verify against the Anti-Patterns table) to give the reference a light workflow spine.
Trim the "When to Apply" list and intro line, which restate the description, to recover token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean — tight Bad/Good code, terse one-line rule summaries, a compact anti-patterns table — with only minor redundancy, notably the "When to Apply" list echoing the description and a restated intro line. | 4 / 5 |
Actionability | Nearly every rule ships concrete, copy-paste TSX (v-stack, gap, dark variant, cn(), responsive prefixes) and an anti-patterns don't→do table; minor gaps are placeholder tokens ("base-classes", "variant-primary") in the cn() example and utilities (z-stack, spacer, circle) that are listed but never demonstrated. | 4 / 5 |
Workflow Clarity | This is a static rules reference, not a multi-step process, so it has no sequenced steps or validation checkpoints; the content is well-organized but the dimension's sequenced-workflow expectations are not met (and the skill exceeds the 50-line simple-skill exception). | 3 / 5 |
Progressive Disclosure | Sectioning is clean (Layout/Color/className/Affordances/Responsive, Anti-Patterns, Key Files) and rule references are signaled one level deep as `@rules/<name>.md`, but no bundle directory exists and the referenced `@rules/*.md` files are not shipped, so the navigation links resolve to nothing. | 3 / 5 |
Total | 14 / 20 Passed |