Content
61%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 compact, well-sectioned overview that correctly delegates implementation detail to a real one-level reference file. Its main weaknesses are missing verification steps (no explicit way to confirm the sitemap is valid or that a fix worked) and moderately actionable instructions that lean on vague phrases like "properly formatted" instead of concrete checks or commands.
Suggestions
Add explicit validation checkpoints: e.g. "Fetch https://<site>/sitemap.xml and confirm a 200 response with `Content-Type: application/xml`", "Validate the XML against the sitemap 0.9 schema", and "Re-check after fixing to confirm the change".
Replace vague phrases like "properly formatted" with the specific requirements (one-level-deep link to references/rule.md for the format spec) or show the minimal <urlset> skeleton inline.
Trim the opening conceptual sentence about what sitemaps are for, and remove the duplicated trailing rule-page URL and stray '---' separator.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and sectioned, with the Quick Reference bullets and Check/Fix/Explain/Code Review sections carrying real information. The one padded spot is the opening sentence "Search engines may not discover all your pages through links alone—a sitemap ensures every important page gets indexed", which explains a concept Claude already knows; trimming it would reach the lean anchor at 5. | 4 / 5 |
Actionability | Some concrete guidance exists — "a valid XML sitemap accessible at /sitemap.xml" and "proper priority and changefreq values" give specific targets — but there are no executable commands or code in the body (e.g. how to fetch/validate the sitemap, curl the URL, check the XML against the sitemap schema), and "properly formatted" is undefined here. This matches the 'some concrete guidance but incomplete' anchor rather than the mostly-executable anchor at 4. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections form a recognizable sequence, but there are no validation checkpoints: nothing says how to confirm the sitemap is valid or how to verify the fix took effect (e.g. re-fetch /sitemap.xml, validate XML, check the HTTP response). The operations are not destructive/batch so the hard cap at 3 doesn't force this score, but the missing checkpoints place it at the 'steps listed but validation gaps' anchor rather than 4. | 3 / 5 |
Progressive Disclosure | The body is a lean overview with clear sections and a well-signaled, one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and the referenced file exists and contains the expected detail (code example, why-it-matters). Minor organization gaps keep it below 5: the pointer is plain text rather than a link, the rule-page URL is duplicated from the frontmatter as a trailing bare line, and the closing '---' separator serves no structural purpose. | 4 / 5 |
Total | 14 / 20 Passed |