Content
67%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 well-structured and actionable with a clear fix workflow and a properly signaled one-level reference, but it spends tokens restating crawler/link concepts Claude already knows and duplicates some content found in references/rule.md.
Suggestions
Remove or shrink the 'Explain' section and the introductory crawler paragraph — Claude already knows how crawlers and internal links work; keep only the dead-end-specific guidance.
De-duplicate the body's 'Code Review' section against references/rule.md 'What to Check' so the detection criteria live in one place and the body stays a lean overview.
Tighten 'Quick Reference' so it does not repeat the Check/Fix steps verbatim; reference those sections instead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro and 'Explain' section restate concepts Claude already knows ('Googlebot follows links to discover and re-crawl pages', 'Internal links are the edges of your site's graph', 'Crawlers navigate by following links'), and Quick Reference overlaps Check/Fix, so it is mostly efficient but padded. | 3 / 5 |
Actionability | Concrete criteria are given ('count `<a href>` links pointing to other pages on the same domain', 'exclude navigation/header/footer', 'Flag any page with zero or fewer than two unique internal links in `<main>` or `<article>`') plus a 6-step Fix; no executable code in the body, but the instruction guidance is actionable with only minor gaps. | 4 / 5 |
Workflow Clarity | The Fix section is a clear 6-step sequence with a validation checkpoint ('Re-crawl after changes to verify the links appear in the rendered DOM'), matching 'clear sequence with most checkpoints present' rather than the full feedback-loop anchor. | 4 / 5 |
Progressive Disclosure | The body is an organized overview pointing one level deep to the verified `references/rule.md` for full details, but the body's 'Explain' and 'Code Review' sections partly duplicate the reference's 'Why It Matters' and 'What to Check', a minor organization gap. | 4 / 5 |
Total | 15 / 20 Passed |