Content
71%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.
A well-structured, actionable body with concrete per-type property requirements and a clean pointer to a real one-level-deep reference file. The main weakness is redundancy — the Check, Fix, and Code Review sections repeat the same procedure, and the Explain section restates concepts Claude already knows.
Suggestions
Merge the 'Check' and 'Code Review' sections — they both describe the identical parse → verify @context/@type → check required properties workflow, so one combined section would remove roughly a third of the body.
Trim the 'Explain' section: descriptions of what rich results are (stars, images, expandable Q&As) are concepts Claude already knows; keep only the non-obvious point that Google silently drops invalid blocks with no error surfaced.
Make the validation feedback loop explicit: after fixing issues, state 're-run the Rich Results Test and iterate until no errors remain' rather than listing validation only as a final step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Individual sentences are lean, but the 'Check', 'Fix', and 'Code Review' sections restate the same parse → verify @context/@type → check required properties procedure nearly verbatim, and the 'Explain' section describes concepts Claude already knows ("enhanced search result formats that include stars, images, expandable Q&s"). Fits anchor 3 (mostly efficient, could be tightened) better than 2 because the fix is merging redundant sections, not cutting padded prose. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact numbered steps, per-type required properties ("Article: headline, author… datePublished"), JSON.parse() for syntax checking, and specific validation URLs (search.google.com/test/rich-results, jsonlint.com). As an instruction-only skill the absence of inline code is not penalized; 'Run through Google's Rich Results Test API if available' is the one under-specified step, keeping it below anchor 5. | 4 / 5 |
Workflow Clarity | Both 'Check' (steps 1–5) and 'Fix' (steps 1–6) present clear numbered sequences with validation checkpoints (Rich Results Test before deploying). The fix→re-validate feedback loop is implied rather than explicitly stated as a retry cycle, which matches anchor 4 rather than 5. This is a read/validate task, not a destructive or batch operation, so the cap-at-3 rule does not apply. | 4 / 5 |
Progressive Disclosure | The body is short (~40 lines) and well-sectioned, and closes with a clearly signaled, one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and the referenced file exists in the bundle (references/rule.md, 159 lines with valid/invalid JSON-LD examples). Matches the clear-overview-with-well-signaled-references anchor. | 5 / 5 |
Total | 16 / 20 Passed |