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 tight, directive instruction skill with excellent token efficiency and a clear four-step sequence. Its weaknesses are dangling references to external materials without locations and absent validation checkpoints to confirm the system file and spec were actually updated.
Suggestions
Give locations for the referenced materials: a path for 'the spec', where the Motion-language standards and mobile matrix documents live, or how to discover the 'matching local taste skill(s)'.
Add a closing validation step (e.g., 'Confirm .hyperflow/design/system.md exists and the spec records the tokens and signature move before finishing') to make the workflow feedback-complete.
Clarify step 2's output requirement — what 'combine them' and 'one deliberate signature move' should be recorded as — so the research step has a verifiable deliverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 18-line body is lean and assumes Claude's competence: rules like 'no default AI gradient, one accent, locked corner-radius scale, eyebrow restraint' are stated as directives with no padding or explanation of concepts Claude already knows, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Mostly executable guidance with concrete specifics ('.hyperflow/design/system.md', '≥2 real-world references', enumerated token categories), but key details are missing: where 'the spec' lives, how to 'Discover and apply the matching local taste skill(s)', and where the 'Motion-language standards' or 'mobile platform/device/accessibility matrix' are found — fitting the 'concrete guidance with minor gaps' anchor. | 4 / 5 |
Workflow Clarity | Four numbered steps in a clear sequence with conditional branches ('when a motion surface is in scope…') and a create-vs-extend decision point, but there are no validation checkpoints (e.g., verifying the spec was updated or the system file is complete). This is design/spec work, not destructive or batch operations, so the workflow cap does not apply; it sits at 'clear sequence with most checkpoints' rather than anchor 5's explicit validation steps. | 4 / 5 |
Progressive Disclosure | A short, well-sectioned body (Steps, Rules) that needs no bundle files, but it references external materials — 'the hyperflow doctrine', 'local taste skill(s)', 'Motion-language standards', the 'mobile platform/device/accessibility matrix' — without signaling where they live (no paths or links), a minor organization gap that keeps it below the top anchor. | 4 / 5 |
Total | 17 / 20 Passed |