Content
57%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 compact, well-structured overview that uses progressive disclosure correctly — a real, one-level-deep reference file carries the code example and verification steps. Its weaknesses are in the in-body guidance itself: the Check step is circular, the opening paragraph explains a concept Claude already knows, and the Check/Fix/Explain/Code Review scaffold is template-generic rather than landmark-specific, leaving actionability and workflow clarity at mid-scale.
Suggestions
Make the 'Check' section concrete: list what to actually verify (one <main> per page, landmarks not duplicated unlabeled, no role='banner'/complementary redundancy, visible labels via aria-label on repeated <nav> elements) instead of the circular 'verify that they are correctly structured'.
Drop the concept-explaining intro paragraph and the meta 'Explain' section; both restate knowledge Claude already has and duplicate the Quick Reference.
Pull the verification checkpoints from references/rule.md (accessibility tree inspection, axe/Lighthouse, keyboard re-test) into the body's Check→Fix flow so the review workflow has explicit validation steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly tight, but it opens with a concept explanation Claude already knows ('Landmark regions allow screen reader users to quickly identify and jump to major sections of a page, significantly improving navigation efficiency') and the 'Check' and 'Explain' sections restate the rule circularly ('Verify that the page uses appropriate HTML5 landmark elements and that they are correctly structured'; 'Explain how landmark regions assist assistive technology users'). This matches the 3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, whose over-explanation is only minor. | 3 / 5 |
Actionability | The Quick Reference and Fix sections give some concrete guidance ('Use HTML5 landmark elements like <header>, <nav>, <main>, and <footer>'; 'Provide labels for multiple landmarks of the same type using aria-label'; 'Replace generic <div> containers with semantic landmark elements'), but the 'Check' section is circular — 'Verify that the page uses appropriate HTML5 landmark elements and that they are correctly structured' restates the rule rather than telling Claude what to look for — and the 'Code Review' section is generic template text. This fits the 3 anchor ('some concrete guidance but incomplete') rather than 4's 'concrete code or commands with minor gaps'; the executable example lives only in references/rule.md, which is acceptable for an instruction-only skill but the in-body guidance itself has real gaps. | 3 / 5 |
Workflow Clarity | A rough review sequence is present (Check → Fix → Explain → Code Review), but the body's 'Check' step gives no concrete checkpoints and verification steps (accessibility-tree inspection, axe/Lighthouse, keyboard re-test) exist only in the referenced references/rule.md, not in the body's flow. This matches the 3 anchor ('steps listed but validation gaps; checkpoints missing or implicit') rather than 4, which requires most checkpoints present in the sequence itself. | 3 / 5 |
Progressive Disclosure | The body is a short, well-sectioned overview that explicitly and cleanly defers detail one level deep — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and references/rule.md exists and delivers exactly what is promised (code example, why-it-matters, exceptions, verification). This matches the 5 anchor ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation') with no nested references or buried pointers. | 5 / 5 |
Total | 14 / 20 Passed |