Content
63%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 well-structured as an overview with an exemplary one-level-deep reference to real implementation content. Its weaknesses are moderate redundancy across the Check/Fix/Quick Reference sections and the absence of any concrete code or fix-verification detail in the body itself.
Suggestions
State the 3-flashes-per-second rule once (Quick Reference or Check) instead of three times, and drop the intro sentence duplicated from references/rule.md's 'Why It Matters'.
Add a minimal executable snippet to the Fix section, e.g., '@media (prefers-reduced-motion: reduce) { *, *::before, *::after { animation-duration: 0.01ms !important; transition-duration: 0.01ms !important; } }'.
Add a verification step after Fix, e.g., 'Verify the fix by emulating prefers-reduced-motion: reduce in browser devtools and confirming animations are disabled.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (~30 lines), but the 3-flashes-per-second rule is stated three times (Quick Reference, Check, and Fix), and the opening sentence about vestibular disorders duplicates the 'Why It Matters' section in references/rule.md. Mostly efficient but could be tightened, matching anchor 3 rather than 4. | 3 / 5 |
Actionability | Concrete elements are present — the exact media query '@media (prefers-reduced-motion: reduce)' and the 3-flashes/second threshold — but the body includes no code snippet and omits key implementation details (how to disable animations, what a motion warning looks like), deferring everything to the reference file. Concrete guidance but incomplete matches anchor 3; not 4 because the body itself contains no executable code or command. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review structure gives a coherent review workflow with explicit criteria (prefers-reduced-motion, flash rate, parallax alternatives, warnings), and this simple review skill triggers no destructive/batch validation cap. Not 5 because the 'Code Review' section is vague boilerplate and no step verifies a fix (e.g., emulating reduced motion in devtools). | 4 / 5 |
Progressive Disclosure | The body is a clean overview with a clearly signaled, one-level-deep reference — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and the referenced file exists (138 lines) and delivers exactly that content, including the CSS example. This matches the anchor-5 structure. | 5 / 5 |
Total | 15 / 20 Passed |