Content
65%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 organized with a clean one-level reference to a real bundle file carrying the implementation detail, and it stays lean. Its weaknesses are executional: the Check step provides no concrete scanning method, and the workflow lacks an explicit validation checkpoint after fixes, leaving Claude to infer how to scan and how to confirm a link is resolved.
Suggestions
Add a concrete scanning method to the Check section — e.g. a wget --spider sweep, a curl status-check loop, or a named link-checker tool — so the scan step is executable rather than aspirational.
Insert an explicit validation step after Fix: re-request the fixed URL and confirm a 200 (or intended redirect) before considering the link resolved, forming a validate-and-retry loop.
Merge the redundant "Check" section into the Quick Reference bullets (they currently duplicate each other) to tighten the body and free tokens for the scanning method.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short (~30 lines) with clear section headers and mostly earns its tokens. It is not a 5 because of minor padding: the intro paragraph ("Internal broken links frustrate users and waste crawl budget by sending search engine bots to non-existent pages, potentially harming your site's SEO") explains consequences Claude already knows, and the "Check" section restates the first Quick Reference bullet. It is well above anchor 3, whose 'unnecessary explanation' would be more substantial. | 4 / 5 |
Actionability | "Scan the website for any internal links that lead to 404 pages or server errors" states the goal but gives no method or command for scanning (no curl/wget --spider/link-checker invocation anywhere in the body), and "Update the broken link to the correct URL or remove it if the destination page no longer exists" is direction rather than executable guidance. Targets and decision rules are specific (404/5xx codes, navigation elements, update-or-remove), which keeps it above anchor 2, but the missing execution details prevent a 4. | 3 / 5 |
Workflow Clarity | A sequence is present (Check → Fix → Explain → Code Review), but validation is implicit at best: "describe how to verify the final page output" defers verification instead of stating a checkpoint, and there is no re-verification step after fixing a link. Since fixing links across a site is a batch-style operation with no validate-and-retry loop, the anchor-3 cap applies; it is above anchor 2 because the steps themselves are well defined. | 3 / 5 |
Progressive Disclosure | The body is a lean overview with clear section headers, and it points to exactly one reference — "see `references/rule.md`" — which exists and appropriately holds the deeper material (code example, why-it-matters, exceptions, verification procedures). The reference is one level deep, clearly signaled, and rule.md itself references nothing further, matching the anchor-5 pattern of a well-split, easily navigable bundle. | 5 / 5 |
Total | 15 / 20 Passed |