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 lean, well-sectioned overview that appropriately defers detail to a single real reference file. Its main weaknesses are the absence of any executable command or code in the body itself and the lack of validation/checkpoint guidance for what is a batch checking-and-fixing workflow.
Suggestions
Include one copy-paste-ready command in the body (e.g., a lychee or linkchecker invocation) so Claude can act immediately without opening the reference.
Add an explicit validation checkpoint to the Check/Fix flow (e.g., re-run the checker after fixes until zero broken links remain) to support the batch fixing loop.
Link to references/rule.md from the relevant sections rather than only as a trailing pointer, so navigation is inline and unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no over-explanation of concepts Claude already knows; every section is brief. Not a 5 because the Quick Reference list and the Code Review sentence repeat information also implied elsewhere, and a few lines could be tightened; not a 3 because there is no padded or redundant explanation of basics. | 4 / 5 |
Actionability | Names concrete tools ("lychee, linkchecker, or broken-link-checker npm packages") and concrete link types to check (internal, external, anchor, mailto), but the body gives no executable commands or code — all detail is deferred to references/rule.md. Not a 4 because nothing in the body is copy-paste ready; not a 2 because specific tool names and check categories are given. | 3 / 5 |
Workflow Clarity | Check/Fix/Explain/Code Review sections provide a rough sequence, but there are no validation checkpoints or a validate-fix-retry loop for the batch link-checking and fixing process, which the rubric caps at 3 for batch operations. Not a 4 because checkpoints are absent; not a 2 because a recognizable sequence is present. | 3 / 5 |
Progressive Disclosure | The body is an overview with clear section headers and a single clearly-signaled one-level-deep reference to references/rule.md (a real file). Not a 5 because the reference is signaled only at the very end as a plain path rather than inline section-level links, and the Quick Reference could point directly to the relevant reference sections; not a 3 because structure and the one-level reference are solid. | 4 / 5 |
Total | 14 / 20 Passed |