Content
88%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 dense, highly executable audit procedure: literal grep patterns, copy-paste fixes, explicit thresholds, a sequenced five-phase workflow with verification checkpoints, and a fully specified output contract. Weak points are minor — some anti-laziness hand-holding and trigger-example sections that restate the description, and contrast/keyboard detection that relies on judgment rather than greps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable content and never explains concepts Claude already knows (no 'what is WCAG' or 'how libraries work' filler), fitting anchor 4. It is not a 5 because 'Tool Use Is Mandatory' repeats the scan-don't-assume instruction three ways, and the five Invocation Examples (~25 lines) plus the closing '## Scope' section restate the description's triggers — padding that assumes the model needs anti-laziness hand-holding. | 4 / 5 |
Actionability | Nearly every detection category ships literal, copy-paste-ready search patterns ("`.font(.system(size:` without `relativeTo:`", "`UIFont(name:` without UIFontMetrics"), executable fixes ("`.custom(\"FontName\", size: X, relativeTo: .body)`", "`UIFontMetrics(forTextStyle: .body).scaledValue(for: 20.0)`"), concrete thresholds ("44x44pt", "4.5:1 for text, 3:1 for large text"), and a full output template. The few judgment-based detections (contrast pairs, focus traversal) are inherent to static analysis and are explicitly routed to the simulator-tester agent for live validation, so anchor 5 is the closest fit. | 5 / 5 |
Workflow Clarity | Five phases are explicitly sequenced (map surface → detect anti-patterns → reason about completeness → cross-reference → score) with validation checkpoints throughout: "For every grep match, use Read to verify the surrounding context before reporting", "Present this map in the output before proceeding", and "Require evidence from the Phase 1 map — don't speculate". The False Positives section acts as an error-recovery loop against over-flagging, and a Testing Checklist closes the process. This is a read-only audit, so the destructive/batch validation cap does not apply; anchor 5 matches. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the skill is a self-contained agent prompt with strong internal header structure and clearly signaled cross-skill pointers ("see `axiom-tools (skills/xcui-ref.md)`", "`axiom-design (skills/typography-ref.md)`"). This fits anchor 4 ("Good structure; most content is appropriately placed; references mostly clear"). It is not a 5 — the monolithic >50-line body has no overview-to-reference split, and the Invocation Examples and '## Scope' sections restate the description; not a 3 because navigation is easy and existing references are clearly signaled, not buried. | 4 / 5 |
Total | 18 / 20 Passed |