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 body is a tight, well-structured overview that defers implementation detail to a real, well-signaled reference file, with concrete Fix guidance naming exact schema types and properties. Its main gaps are the mildly redundant intro/Quick Reference and the lack of concrete verification methods inside the body itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: terse Quick Reference bullets and one-line Check/Fix/Explain sections that assume Claude's competence, with details correctly deferred to references/rule.md. It is not 5 because the opening rationale sentence ('Structured author information helps search engines uniquely identify authors...') explains a 'why' Claude already knows and the Quick Reference partially duplicates the Fix section. | 4 / 5 |
Actionability | The Fix and Quick Reference give concrete, specific instructions — 'Use JSON-LD', 'Include properties like name, url, sameAs, and jobTitle', 'Add a Person or Organization schema to your JSON-LD block and link it to the author property' — and point to a real reference file containing a full executable code example. It falls short of 5 because the Check and Code Review sections give no concrete method or tool for inspecting rendered HTML/headers (e.g., a view-source grep or Rich Results Test), leaving minor gaps. | 4 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections form a coherent audit-fix-verify sequence with checkpoints (verify presence before fixing, then 'describe how to verify the final page output' after). It is not 5 because the verification checkpoint in the body is stated abstractly rather than as explicit steps or commands, though the referenced rule.md does carry a detailed Verification section. | 4 / 5 |
Progressive Disclosure | The body is a well-organized ~45-line overview with clear sections and a single, clearly signaled one-level-deep reference ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), which exists and holds the code example, standards, and verification detail. This matches the anchor for a clear overview with well-signaled references and appropriate content split. | 5 / 5 |
Total | 17 / 20 Passed |