Content
42%Reviews 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 correctly offloads detail to a real one-level reference, but it is largely abstract: it tells Claude to validate and fix HTML without concrete tooling, commands, or a verify→fix→re-verify loop. Actionability is the clear weak point.
Suggestions
Add concrete executable guidance to the body — e.g. a validation command or tool (W3C validator, html-validate, or a curl-and-inspect snippet for the rendered HTML/HTTP response) instead of 'Validate the HTML structure of the page'.
Turn the Check→Fix flow into a verify→fix→re-verify loop with an explicit validation checkpoint (re-run the validator / re-fetch the rendered HTML) before marking the rule satisfied.
Drop or shrink the opening impact paragraph and the 'Explain' section, since the crawling/accessibility consequences of malformed HTML are concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean sectioned prose, but the opening paragraph ('Malformed HTML can cause rendering issues... may prevent search engine crawlers from...') and the 'Explain' section restate impact concepts Claude already knows, so it is not fully tight. | 2 / 3 |
Actionability | The body only describes ('Validate the HTML structure...', 'Correct the malformed HTML by properly closing tags') with no concrete commands, tooling, or executable examples — the only code lives in references/rule.md, so it describes rather than instructs. | 1 / 3 |
Workflow Clarity | A Check → Fix → Explain → Code Review sequence is present, but there are no validation checkpoints or feedback loops even though this is a verify-then-fix audit workflow where re-verification matters. | 2 / 3 |
Progressive Disclosure | The body is a concise overview that clearly signals a single one-level-deep reference ('see references/rule.md'), and that file exists and holds the detailed code/standards — clean, shallow navigation. | 3 / 3 |
Total | 8 / 12 Passed |