Content
86%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.
A well-crafted, token-efficient instruction-only skill: terse audit rules, a coherent audit-implement-verify structure, and exemplary progressive disclosure with condition-triggered references that resolve to real files. The only notable gap is that executable specifics (matcher names, commands, thresholds) live entirely in the references rather than the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean with no padding or explanation of concepts Claude already knows — "Treat accessibility as behavior to implement and verify, not a label-only cleanup" earns its place as a framing principle, and every rule is a terse directive. Matches anchor 5 (lean, assumes competence, every token earns its place); anchor 4's 'minor instances of over-explanation' does not apply. | 5 / 5 |
Actionability | Concrete directives like "Prefer semantic built-in controls before manually adding `Semantics`" and "Use widget tests with semantics enabled and Flutter's accessibility guideline matchers" give mostly executable guidance, and as an instruction-only skill the absence of code is not penalized. Not a 5 because specifics a user would need to execute — named matchers, test commands, concrete threshold numbers — are deferred to references and "where suitable" hedges the verification advice. | 4 / 5 |
Workflow Clarity | A clear audit → apply rules → verify arc: "Audit the flow" lists what to identify, Rules state what to enforce, and Verification specifies widget tests plus "TalkBack or VoiceOver and keyboard navigation". Matches anchor 4 (clear sequence with most checkpoints present); not a 5 because verification is not woven in as an explicit validate-and-fix loop, and not a 3 because a concrete verification section is present. | 4 / 5 |
Progressive Disclosure | The body is a concise overview with two one-level-deep references, each clearly signal-conditioned: "Read [semantics and screen readers](references/semantics-and-screen-readers.md) when annotating custom widgets..." and "Read [target sizes and contrast](references/target-sizes-and-contrast.md) when auditing WCAG AA contrast ratios...". Both referenced files exist in the bundle with real content, and nothing that belongs in a reference is inlined — matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |