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-organized, lean instructional body with unusually concrete design parameters and a real validation section. Its main defects are bundle-related: a dead ARTICLE.md reference and 13 bundled asset images that are never mentioned, plus minor redundancy between the Avoid section and earlier rules.
Suggestions
Add the missing ARTICLE.md (or fix the 'Mara Voss Interaction Prompt Pack' link to point at an existing file) so the Source-Backed Prompt Pack section is executable.
Reference the 13 assets/*.png files from the body (e.g., in the prompt-pack or interaction sections) so the bundled images are discoverable and purposeful.
Trim the Avoid bullets that restate earlier guidance (e.g., 'Hiding project titles or actions until hover' duplicates the Projects and panel-reveal rules) to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout, assuming competence (uses 'clamp()', 'cubic-bezier(.22,.61,.36,1)' unexplained) with no concept explanations. Not a 5 because the Avoid section restates rules already given ('Hiding project titles or actions until hover' repeats 'show title, role, year, and action without hover'; 'Fast card choreography... decorative motion loops' overlaps 'Do not hijack scroll' / 'Keep parallax below 5%'). | 4 / 5 |
Actionability | Highly concrete numeric guidance ('40-64px desktop edge margins', '500-760ms mask or shallow translate', 'scale media no more than 1.02', 'Stagger direct children by 45-70ms') plus explicit behavior requirements (Escape support, focus return, reduced motion). Not a 5 because the 'Source-Backed Prompt Pack' step points to [ARTICLE.md](ARTICLE.md), which does not exist in the bundle, leaving that instruction unexecutable. | 4 / 5 |
Workflow Clarity | A clear top-to-bottom sequence (Establish the Story -> Build the Visual System -> Compose the Page -> Interactions -> Motion Defaults -> Validate) with an explicit validation checklist ('Test keyboard, touch, 200% zoom, narrow mobile, slow media, missing media, and reduced motion'). Not a 5 because there is no fix-and-revalidate feedback loop and the prompt-pack step cannot be executed due to the missing ARTICLE.md. | 4 / 5 |
Progressive Disclosure | The body itself is well-sectioned, but the bundle structure is mishandled: the only reference link ([ARTICLE.md](ARTICLE.md) in 'Source-Backed Prompt Pack') is broken - no such file exists - and the 13 PNG files in assets/ are never referenced from the body, leaving them orphaned and undiscoverable. | 3 / 5 |
Total | 15 / 20 Passed |