Content
78%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 content is well-structured, actionable, and appropriately splits detail into references/rule.md with a clear overview. Tightening the intro and adding an explicit validate-and-retry loop in Fix would push it higher.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean bullets and concrete property lists, with only the opening motivational paragraph ('Pages with valid VideoObject schema are eligible for video-specific rich results...') adding explanation Claude largely already knows. | 4 / 5 |
Actionability | Check and Fix give concrete, executable guidance (find <video>/iframes, look for the JSON-LD block, populate name/description/thumbnailUrl/uploadDate, run the Rich Results Test), though no inline code example is provided — code is deferred to references/rule.md. | 4 / 5 |
Workflow Clarity | A clear Check → Fix → Explain → Code Review sequence with an explicit validation checkpoint (Google's Rich Results Test) in both Check and Fix, but the Fix step does not spell out the retry-on-failure loop explicitly. | 4 / 5 |
Progressive Disclosure | The body is a well-sectioned overview (Quick Reference, Check, Fix, Explain, Code Review) with a single clearly signaled one-level-deep reference to references/rule.md, which exists as a real file — easy to navigate. | 5 / 5 |
Total | 17 / 20 Passed |