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 a well-structured, efficient overview for a single-purpose audit rule: concrete checks and fixes, clear sequencing, and proper delegation of detail to an existing one-level-deep reference. Remaining weaknesses are minor — slight duplication between the intro and Quick Reference, and verification guidance that names the step but not the method.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's competence, and pads nothing — no explanations of what structured data or noindex are. The Quick Reference bullets ('Rich result schema... has no effect', 'A page with noindex will not earn rich results') partially duplicate the intro sentence and the Check section, keeping it at anchor 4 rather than 5. | 4 / 5 |
Actionability | The Check section gives concrete, executable checks ('<script type=application/ld+json>' blocks, robots.txt block, 'noindex' in meta robots, canonical pointing elsewhere) and Fix gives specific remediation with a branch for pages that must stay noindexed. Minor gaps: no concrete method for finding schema pages across a large site (e.g., a crawl or grep command), and the executable HTML example lives only in the reference file — anchor 4. | 4 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is clear, the Fix section branches on intent (rich results desired vs. page must remain noindexed), and the Check list functions as an explicit audit checkpoint. Verification is mentioned ('describe how to verify the final page output') but no concrete verification method (e.g., Rich Results Test, URL Inspection) is given — anchor 4 with minor validation gaps, not 5. | 4 / 5 |
Progressive Disclosure | The body is a concise overview that appropriately delegates implementation details, code examples, and framework guidance to a clearly signaled, one-level-deep reference ('see references/rule.md'), which exists as a real 120-line file with the detailed rule and an HTML code example. This matches anchor 5: clear overview, well-signaled one-level-deep references, easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |