Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, token-efficient overview with excellent progressive disclosure into references/rule.md. Its weaknesses are an implicit workflow without explicit feedback loops and actionability that leans on the reference for executable code rather than providing a copy-paste example inline.
Suggestions
Add a short numbered Check → Fix → Validate sequence with an explicit 'if validation fails, fix and re-test' feedback loop.
Include one minimal copy-paste JSON-LD AggregateRating example inline so the Fix step is executable without opening the reference.
Make the validation checkpoint a distinct, emphasized step rather than a trailing mention in Quick Reference and Check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (~30 lines), assumes Claude's competence, and avoids padding with concepts Claude already knows; every section earns its place, matching the anchor-3 'lean and efficient' example. | 3 / 3 |
Actionability | The Check section names concrete detection strings and required properties and points to Google's Rich Results Test, and the Fix describes a JSON-LD structure, but the body itself contains no executable/code example — it defers those to the reference — so it lands at 'some concrete guidance but incomplete' rather than copy-paste ready. | 2 / 3 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections imply a sequence and validation is mentioned ('Run the URL through Google's Rich Results Test', 'before deploying'), but there is no numbered step sequence or explicit validate→fix→revalidate feedback loop, so checkpoints are implicit. | 2 / 3 |
Progressive Disclosure | The body is a concise overview that clearly signals a one-level-deep reference ('see references/rule.md' for full implementation details, code examples), and that file exists and holds the detailed content, matching the anchor-3 'clear overview with well-signaled one-level-deep references'. | 3 / 3 |
Total | 10 / 12 Passed |