Content
71%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, token-efficient overview that delegates detail appropriately to a real, accurately-described reference file. Its main weakness is actionability: the check and fix directives name the goal but provide no in-body example or verification mechanism, so execution depends entirely on the reference.
Suggestions
Add a minimal correct-vs-incorrect markup pair (a td with headers="h-q1" pointing at a real th id, versus a stale/duplicate id) so the check is executable without opening the reference.
Name one concrete verification method in the body (e.g. an axe rule id or a quick DOM query for td[headers] ids not matching any th id) instead of the generic "browser accessibility tooling" phrasing.
Trim or merge the boilerplate Code Review paragraph into the Check section, since it largely restates the description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows, but the generic "Code Review" paragraph ("Flag exact elements, roles, labels, focus behavior, or keyboard interactions...") is boilerplate that adds little beyond the description and could be trimmed. | 4 / 5 |
Actionability | "Verify that `td` headers attributes reference valid and existing `th` IDs" is a concrete, doable check, but the body contains no correct/incorrect markup example, selector, or verification command — the executable how is entirely delegated to references/rule.md, leaving key details missing. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain → Code Review sections give a clear, unambiguous progression for a single-purpose, non-destructive skill, though no explicit re-verification step appears in the body's own sequence (verification steps live only in the reference). | 4 / 5 |
Progressive Disclosure | The body is a concise overview with a single well-signaled, one-level-deep pointer ("For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`") that accurately describes the reference's contents; the reference exists and nests no further references. | 5 / 5 |
Total | 16 / 20 Passed |