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 well-structured, concise overview that appropriately points one level deep to references/rule.md for details. Its weaknesses are actionability and workflow clarity: the standalone body lacks executable verification steps and an explicit validation checkpoint, relying on the reference for the concrete "how".
Suggestions
Add a brief inline verification snippet (e.g. an axe/Lighthouse check or an accessibility-tree inspection step) so the body is actionable without requiring the reference.
Replace the loose Check/Fix/Explain/Code Review sections with a numbered review workflow that includes an explicit validation checkpoint.
Move or merge the meta "Explain" section into the reference to keep the body purely task-oriented and trim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and avoids over-explaining concepts Claude already knows, with tight Quick Reference bullets and one-line Check/Fix directives; the meta "Explain" section ("Explain why every header must have associated data...") is mild padding that could be trimmed. | 4 / 5 |
Actionability | Gives directional guidance ("Verify that all <th> elements are correctly associated", "Remove empty headers or ensure they are correctly mapped to data cells") but defers the concrete "how" — actual code examples and verification tooling — to references/rule.md, leaving the body incomplete as standalone instruction. | 3 / 5 |
Workflow Clarity | Sections (Check, Fix, Explain, Code Review) suggest a loose sequence but are not a clearly numbered workflow, and there is no explicit validation/verification checkpoint in the body — verification steps live only in the reference file. | 3 / 5 |
Progressive Disclosure | The body acts as a clear overview with a well-signaled, one-level-deep pointer to references/rule.md (confirmed to exist) for full implementation details; organization is good, though some inline meta-content like the "Explain" section could itself sit in the reference. | 4 / 5 |
Total | 14 / 20 Passed |