Content
78%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-structured overview for a simple single-purpose rule: concrete check and fix guidance, a coherent Check/Fix/Explain/Code Review flow, and an appropriately signaled one-level reference to rule.md that carries the code examples. Remaining weaknesses are minor — slight duplication between Quick Reference and Check/Fix, and a vague verification gesture ('browser accessibility tooling') with no named tool or check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body assumes Claude's competence — no explanations of what HTML or headings are — with each section delivering one directive ("Find any heading tags (h1 through h6) that are empty or contain only non-perceivable whitespace"). It falls at anchor 4 rather than 5 because the Quick Reference bullets ('Add visible, descriptive text to all heading elements', 'Avoid using headings solely for styling...') partially duplicate the Check/Fix sections and could be trimmed, and the Explain section is a meta-instruction that adds little. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is actionable: the Check gives a specific criterion (headings h1-h6 that are empty or whitespace-only), and the Fix gives two concrete options ("Add descriptive text content to the empty heading or remove the heading tag if it's not needed"), with executable code examples delegated to references/rule.md. It stays at 4 rather than 5 because no concrete detection mechanism (e.g., a selector like h1:empty, an axe/Lighthouse rule, or a grep pattern) is given inline — a minor gap per the instruction-only scoring note. | 4 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sequence is coherent and the single action (find and fix empty headings) is unambiguous, with Code Review gesturing at verification ("note how to verify the fix with browser accessibility tooling or assistive tech"). It is not 5 because the verification step is vague — no specific tool or check is named — matching anchor 4's 'clear sequence with most checkpoints present; minor validation gaps'. No cap applies since this is not a destructive or batch operation. | 4 / 5 |
Progressive Disclosure | The body is a lean overview with well-organized sections (Quick Reference, Check, Fix, Explain, Code Review) and a single, clearly signaled, one-level-deep pointer: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — the file exists (63 lines with good/bad HTML examples) and nothing is nested further. This matches the anchor-5 pattern exactly. | 5 / 5 |
Total | 17 / 20 Passed |