Content
92%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-engineered instruction skill: opinionated and concrete guidance, a clearly gated workflow with validation checkpoints, and exemplary progressive disclosure that pushes the 31KB reference material into conditionally loaded files. The only meaningful improvement space is trimming restated routing and ban rules scattered across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense rule-bearing prose with no explanation of concepts Claude already knows, and heavy detail (31KB design reference, mode files) is correctly offloaded to references. It is not a 5 because several rules are stated more than once (routing logic appears in both the Mode Picker and the Chinese gut-feel paragraph; bans recur in Hard Rules and the AI Slop Test) and a few long paragraphs could be tightened. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: five named direction dimensions with resolution rules, exact reference-site properties to extract ("button radius philosophy, surface depth treatment, accent color family"), exact token filenames to read ("theme.ts, colors.ts, tokens.css, _variables.scss"), named viewport states to test ("minimum width, minimum height, their combination, and normal size"), and a gotchas table with specific fixes. This matches the top anchor once the instruction-only adaptation is applied. | 5 / 5 |
Workflow Clarity | The sequence is explicit and gated: mode pick, direction lock ("Do not write code until all five are resolved"), three-line thesis, build, aesthetic review with the AI Slop Test, viewport verification, handoff, stop. Validation checkpoints and feedback loops are present ("If any check fails, fix first"; a contradictory answer "must be resolved before that deliverable proceeds"), and the fallback when the host cannot render is named. | 5 / 5 |
Progressive Disclosure | The body is an overview that splits detail into seven real, one-level-deep reference files, each loaded under a stated condition via the mode-picker table and exception routes. All referenced paths exist in references/, and named sections cited from design-reference.md ("App shell rules", "Absolute Bans", "Options Guide", "Aesthetic Review Checks") are present in that file, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |