Content
57%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-organized and correctly uses a single one-level-deep reference, but it leans on redundant explanatory prose and stops short of giving fully copy-paste-ready examples with explicit verification steps. Tightening the explanation and adding a complete executable example would raise the score.
Suggestions
Replace the prose-heavy intro and "Explain" section with a single complete example: `<video poster='thumbnail.jpg' width='1280' height='720' controls preload='metadata'></video>`.
Add an explicit verification checkpoint after Fix, e.g. "Confirm the poster URL returns 200 (no 404) and that `width`/`height` are set to prevent CLS."
Remove restated basics about what a poster/black-rectangle is; assume Claude's knowledge and keep only the rule-specific guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with clear sections, but the opening paragraph and the "Explain" section restate UX/perceived-performance concepts (e.g. "displays as a blank black rectangle", "visually jarring") that overlap with each other and with what Claude already knows. | 2 / 3 |
Actionability | Provides a concrete snippet (`<video poster='thumbnail.jpg' controls>`) and specific numbers (1280×720, 16:9), but never shows a complete copy-paste-ready `<video>` element combining poster, width, and height, leaving the guidance concrete yet incomplete. | 2 / 3 |
Workflow Clarity | Check and Fix steps are numbered and sequenced, and the Check section includes a verification idea ("the URL resolves to a valid image (no 404s)"), but validation checkpoints are implicit rather than explicit runnable steps, so the sequence lacks clear feedback loops. | 2 / 3 |
Progressive Disclosure | The body is a concise, well-sectioned overview (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep pointer to the existing `references/rule.md`, matching the good anchor for clean navigation. | 3 / 3 |
Total | 9 / 12 Passed |