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 a well-organized, concise overview that appropriately delegates detailed code to a real one-level reference. Its main weaknesses are repeated vestibular explanation, generic Code Review boilerplate, and in-body guidance that defers all executable examples to the reference.
Suggestions
State the vestibular-mismatch explanation once (e.g., in the intro) and drop its repetition in the Quick Reference bullet and Explain section to tighten the body.
Replace the generic 'Code Review' boilerplate ('Flag exact elements, roles, labels, focus behavior, or keyboard interactions') with parallax-specific review steps, since the current text overlaps the description's generic accessibility language.
Add a brief in-body verification checkpoint (e.g., 'Verify with OS Reduce-motion enabled that parallax is disabled and content stays readable') rather than deferring all verification to references/rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, but the vestibular-mismatch point is repeated three times ('Parallax creates a mismatch...' in the intro, a Quick Reference bullet, and the Explain section), and the generic 'Code Review' boilerplate adds little parallax-specific value. | 2 / 3 |
Actionability | The Fix section names concrete techniques ('Wrap parallax effects in @media (prefers-reduced-motion: no-preference) queries,' static fallbacks, a motion toggle) but provides no in-body executable code and hedges with 'Consider adding,' deferring all examples to references/rule.md. | 2 / 3 |
Workflow Clarity | As a simple, single-purpose rule skill it is clearly organized into Check → Fix → Explain → Code Review sections with a concise overview, which per the simple-skills note warrants full marks even without an explicit multi-step workflow. | 3 / 3 |
Progressive Disclosure | The body is a concise overview that clearly signals a single one-level-deep reference — 'see references/rule.md' — which exists and holds the full code examples and framework guidance, matching well-structured progressive disclosure. | 3 / 3 |
Total | 10 / 12 Passed |