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.
The body is a tight, well-structured overview with genuinely actionable field-level checks and correct progressive disclosure to a real references file. Its one clear weakness is redundancy: the Check, Code Review, and Explain sections overlap heavily, inflating token cost without adding guidance.
Suggestions
Merge 'Check' and 'Code Review' into a single verification section — they repeat the same find-blocks/verify-fields/match-price/run-Rich-Results-Test steps with only format details differing.
Fold the 'Explain' section into the intro paragraph; both make the same rich-result/CTR argument, so one mention suffices.
Move the field format constraints that only appear in 'Code Review' (absolute URL array, numeric price, ISO 4217, schema.org availability URL) up into the 'Fix' required/recommended field lists so one section carries the full spec.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short, but 'Check' and 'Code Review' largely duplicate each other (both: 'Find/Check JSON-LD blocks with @type Product', 'verify required fields', 'price matches visible page', 'Validate with Google's Rich Results Test'), and 'Explain' repeats the intro's rich-result/CTR claim. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened') rather than 2, since the padding is duplicated sections, not explanation of concepts Claude doesn't know. | 3 / 5 |
Actionability | The guidance is concrete and executable without code: exact required fields with format constraints ('offers.price (numeric)', 'ISO 4217 code', 'schema.org URL', 'absolute URL array'), a named validation tool ('Google's Rich Results Test'), and a price-match invariant. It fits anchor 4 ('Mostly executable guidance... minor gaps') rather than 5 because the body itself contains no copy-paste JSON-LD example — the example lives only in references/rule.md, which per the rubric's scoring notes is not penalized further for an instruction-oriented skill. | 4 / 5 |
Workflow Clarity | The Check → Fix → Code Review structure forms a clear single-purpose sequence with explicit checkpoints ('Check that prices in schema match the visible page prices', 'Validate with Google's Rich Results Test', 'reviewCount > 0 if rating is present'), fitting anchor 4. It is not 5 because there is no error-recovery loop (what to do when the Rich Results Test fails is only implied by the Fix section), and the validation steps are spread across three near-duplicate sections instead of one ordered checklist. | 4 / 5 |
Progressive Disclosure | The body is a lean overview under 50 lines, well-sectioned (Quick Reference, Check, Fix, Explain, Code Review), with a clearly signaled one-level-deep pointer that matches the real bundle: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' (file exists; no nested references inside it). This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split'). | 5 / 5 |
Total | 16 / 20 Passed |