Content
60%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 a compact, well-sectioned overview that delegates implementation detail to a real, clearly signaled one-level reference, and the Check→Fix sequence includes a measurement checkpoint. Its weaknesses are duplicated Quick Reference/Explain prose that adds tokens without information, and the absence of any inline executable example or conversion command in the Fix section.
Suggestions
Inline a minimal executable example in the Fix section (the <video autoplay loop muted playsinline> markup plus an ffmpeg conversion command such as `ffmpeg -i animation.gif -movflags faststart -pix_fmt yuv420p animation.mp4`) so the core action is executable without opening the reference.
Remove the Quick Reference bullets that restate the intro and Fix sections, and drop the vague 'Explain' section in favor of the reference's 'Why It Matters' content.
Replace the body's 'Code Review' section, which repeats the description's audit language, with a short pointer to the verification steps already in references/rule.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and free of known-concept padding, but there is noticeable duplication: the Quick Reference bullets ("Use `<video>` instead of large GIFs for animations", "GIFs are significantly larger than MP4/WebM") restate the intro paragraph and the Fix section, and the thin "Explain" and "Code Review" sections add little new information. This fits the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened'). Not a 4 because the redundancy across intro/Quick Reference/Fix is more than minor trimming; not a 2 because the body is compact and does not explain basics Claude already knows. | 3 / 5 |
Actionability | The Fix section gives concrete but incomplete guidance: "Convert animated GIFs to MP4 or WebM and use the `<video>` tag with `autoplay`, `loop`, `muted`, and `playsinline` attributes" names formats and exact attributes, yet the body contains no executable code or command — no ffmpeg conversion command and no <video> markup, both of which live only in references/rule.md. This matches the 3 anchor ('some concrete guidance but incomplete; missing key details'). Not a 4 because there is no inline code or command to execute; not a 2 because the guidance is specific about formats and attributes rather than a high-level hint. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain sequence is clearly ordered for this simple task, and the Code Review section supplies a verification checkpoint ("describe the measurement method used to confirm the issue"), matching the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps'). Not a 5 because verification is described loosely rather than as an explicit measure-then-confirm loop, and the Check step gives no measurement method (that detail is deferred to the reference); not a 3 because the sequence and checkpoints are present and unambiguous. | 4 / 5 |
Progressive Disclosure | The body is a short overview with a clearly signaled one-level-deep reference that exists on disk: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`", matching the 4 anchor ('good structure; most content appropriately placed; references mostly clear'). Not a 5 because the split is slightly uneven — the body's Code Review section largely duplicates the description's audit language instead of overview content, and the referenced file itself opens its code section with a stray empty '## Code Examples' heading followed by a lone '#' line, slightly muddying navigation into the bundle. Not a 3 because structure and signaling are good, the reference is real, and details are appropriately delegated. | 4 / 5 |
Total | 14 / 20 Passed |