Content
70%Reviews 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 and appropriately uses progressive disclosure with a real one-level reference, with a clear Check-to-Fix workflow for a simple rule; its main weaknesses are redundant content between sections and the lack of an executable code example.
Suggestions
Remove the overlap between the Quick Reference bullets and the Fix section, and drop the duplicate vestibular-disorder rationale that already appears in the intro and the Explain section.
Add a concrete, copy-paste-ready CSS snippet in the Fix section, e.g. the '@media (prefers-reduced-motion: no-preference) { html { scroll-behavior: smooth; } }' pattern, so the guidance is executable rather than descriptive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean, but the Quick Reference bullets duplicate the Fix section (e.g., 'scroll-behavior: smooth' with a prefers-reduced-motion check appears in both) and the vestibular-disorder rationale is restated in both the intro and the Explain section, so it could be tightened. | 2 / 3 |
Actionability | The Fix section names concrete specifics ('scroll-behavior: smooth only within a prefers-reduced-motion media query check', 'focus moves to the anchor target'), but provides no copy-paste-ready CSS snippet, leaving the guidance descriptive rather than executable. | 2 / 3 |
Workflow Clarity | This is a simple single-rule skill with an unambiguous action and an explicit verification step in the Check section ('verify smooth scrolling is disabled when prefers-reduced-motion is set'), satisfying the simple-skill allowance for a top score. | 3 / 3 |
Progressive Disclosure | A short, well-organized overview points to a clearly signaled, one-level-deep reference ('see references/rule.md'), and that file exists, matching the clear-overview-with-well-signaled-references anchor. | 3 / 3 |
Total | 10 / 12 Passed |