Content
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with a clear overview and a properly signaled single reference file, achieving good progressive disclosure. Its main weaknesses are duplicated check instructions, an Explain section that over-justifies known concepts, and the absence of a concrete markup/schema example and a verify-after-fix step.
Suggestions
Merge the Check and Code Review sections (they repeat the same verification list) and trim the Explain rationale to only the non-obvious LocalBusiness/Google Business Profile matching point, reducing redundancy.
Add a short copy-paste example of an <address> element with matching LocalBusiness PostalAddress JSON-LD to make the Fix fully actionable.
Add an explicit post-fix verification step (re-check that the visible address, JSON-LD, and Google Business Profile all match exactly) to give the Check→Fix flow a clear validation checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with bulleted Quick Reference and short sections, but the Check and Code Review sections repeat nearly identical verification instructions and the Explain section restates widely-known trust/SEO rationale, fitting the 'mostly efficient but could be tightened' anchor rather than the every-token-earns-its-place level 3. | 2 / 3 |
Actionability | Guidance is concrete (specify street/city/state/postal/country, wrap in <address>, match LocalBusiness JSON-LD and Google Business Profile exactly), but no example <address> markup or JSON-LD snippet is provided, leaving it at 'some concrete guidance but incomplete / missing key details' rather than copy-paste ready level 3. | 2 / 3 |
Workflow Clarity | A Check-then-Fix sequence is present and the Check section acts as a verification checklist, but there is no explicit validate-after-fix step or feedback loop, matching the 'steps listed but validation checkpoints missing or implicit' anchor. | 2 / 3 |
Progressive Disclosure | SKILL.md is a concise overview that clearly signals a single one-level-deep reference ("see references/rule.md"), and that file exists, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 3 / 3 |
Total | 9 / 12 Passed |