Content
63%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 with clean mode sections and exemplary progressive disclosure to a real reference file, but it suffers from token-redundant repetition and lacks any concrete detection method or example in the body itself. The workflow would also benefit from an explicit post-fix re-validation step.
Suggestions
Remove the verbatim duplication of the duplicate-ID consequences (the intro paragraph repeats Quick Reference bullet 4) to reclaim tokens.
Add a concrete detection method to the Check section, e.g. a one-liner to list duplicate IDs (grep/sort/uniq or a small JS snippet) or a short good/bad HTML example.
Add a re-validation step after Fix ('re-scan the rendered markup to confirm no duplicates remain and all references resolve') to close the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly lean, but the duplicate-ID consequences are stated twice nearly verbatim (intro paragraph and Quick Reference bullet 4), and the intro re-explains basic HTML facts ('Duplicate IDs break form accessibility... getElementById returns wrong elements') Claude already knows. | 3 / 5 |
Actionability | Per-mode directives include some concrete details ('update any references like labels, ARIA attributes, or JavaScript selectors', 'Flag exact elements, attributes, and routes'), but the Check section gives no detection method or command ('Scan this HTML document' says nothing about how) and the body contains no example, leaving execution details incomplete. | 3 / 5 |
Workflow Clarity | Check → Fix → Explain → Code Review sections are clearly delineated with the Check step serving as validation before fixing, but there is no re-validation after Fix and no feedback loop, matching the 'clear sequence with minor validation gaps' anchor. | 4 / 5 |
Progressive Disclosure | The short, well-sectioned body is a genuine overview that defers all code examples and framework-specific guidance to references/rule.md (verified to exist), which is clearly signaled and exactly one level deep — matching the clean split-and-navigate anchor. | 5 / 5 |
Total | 15 / 20 Passed |