MaarkssDN/Birthub-360 / .agents/skills/axe-a11y
axe-a11y
VerifiedUse whenever pages or components need automated accessibility scanning: axe-core via axe.run(), @axe-core/playwright or the CLI on every PR, rule configuration and CI-gateable results, plus pa11y, Lighthouse CI accessibility, WAVE and IBM Equal Access (Section 508) in its references.
| File | Kind | Size |
|---|---|---|
| .tessl-plugin/plugin.json | config | 409 B |
| SKILL.md | skill md | 9.1 KB |
| evals/dialog-fix-signed-off-by-a-green-run/criteria.json | config | 7.5 KB |
| evals/dialog-fix-signed-off-by-a-green-run/task.md | markdown | 10.1 KB |
| evals/pr-bot-has-said-no-issues-for-four-months/criteria.json | config | 7.6 KB |
| evals/pr-bot-has-said-no-issues-for-four-months/task.md | markdown | 10.1 KB |
| evals/three-scanners-one-number-for-the-board/criteria.json | config | 7.6 KB |
| evals/three-scanners-one-number-for-the-board/task.md | markdown | 14.6 KB |
| evals/two-symptoms-since-we-added-accessibility/criteria.json | config | 5.5 KB |
| evals/two-symptoms-since-we-added-accessibility/task.md | markdown | 7.3 KB |
| evals/zero-tolerance-announced-for-monday/criteria.json | config | 7.7 KB |
| evals/zero-tolerance-announced-for-monday/task.md | markdown | 10.0 KB |
| references/ibm-equal-access.md | markdown | 5.2 KB |
| references/lighthouse-a11y.md | markdown | 5.5 KB |
| references/pa11y.md | markdown | 5.0 KB |
| references/results-and-config.md | markdown | 3.0 KB |
| references/wave.md | markdown | 4.8 KB |
references/results-and-config.md
View on GitHub# axe-core results structure and rule configuration
## Results structure
`axe.run()` resolves to an object with four arrays ([axe-core][readme]):
| Field | Meaning |
|----------------|---------------------------------------------------------------|
| `violations` | Definite issues - block this in CI. |
| `incomplete` | Items needing human review (axe couldn't determine). |
| `passes` | Successful checks. |
| `inapplicable` | Rules that don't apply to this page. |
Each violation has:
| Field | Meaning |
|----------------|---------------------------------------------------------------|
| `id` | Rule ID (e.g. `color-contrast`, `label`, `aria-required-attr`). |
| `impact` | `critical` / `serious` / `moderate` / `minor`. |
| `tags` | Includes `wcag2a`, `wcag22aa`, etc. - for severity-by-SC tagging. |
| `description` | One-line explanation. |
| `help` | Longer remediation guidance. |
| `helpUrl` | Direct link to Deque's rule documentation. |
| `nodes` | Array of failing elements with `target` (selector), `html`, `failureSummary`. |
Triage with `jq`:
```bash
# Top violations by impact
jq -r '.violations[] | "\(.impact): \(.id) - \(.description)"' axe-results.json
# Just the failing selectors per rule
jq -r '.violations[] | "\(.id):", (.nodes[].target | tostring)' axe-results.json
```
## Rule configuration
### By tags
axe ships rules tagged with conformance levels:
```javascript
new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa', 'wcag22aa'])
```
Common tag sets:
| Tag set | Coverage |
|------------------------------------------------------------|----------------------------------|
| `['wcag2a', 'wcag2aa']` | WCAG 2.0/2.1 A + AA. Default for most teams. |
| `['wcag2a', 'wcag2aa', 'wcag22aa']` | Adds WCAG 2.2 AA criteria. |
| `['wcag2aaa']` | AAA-only (rarely the gate). |
| `['best-practice']` | Non-WCAG good practices. |
| `['experimental']` | Beta rules. |
### Disable specific rules
```javascript
new AxeBuilder({ page }).disableRules(['color-contrast'])
```
For per-page disabling (e.g. a known false positive on a specific
component):
```javascript
new AxeBuilder({ page })
.exclude('.legacy-component') // selector exclusion
.analyze();
```
For per-rule severity in CI gating (e.g. block on `critical` /
`serious` only): handle in `a11y-violation-gate` using the `impact`
field.
[readme]: https://github.com/dequelabs/axe-core
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |