MaarkssDN/Birthub-360 / .agents/skills/a11y-violation-gate
a11y-violation-gate
VerifiedUse when a project has accessibility debt and a zero-violations gate would block every PR. Builds a CI ratchet that fails only on new WCAG violations a PR introduces, with pre-existing ones baselined per rule and page, from axe-core, pa11y, Lighthouse, WAVE or IBM Equal Access results.
| File | Kind | Size |
|---|---|---|
| .tessl-plugin/plugin.json | config | 422 B |
| SKILL.md | skill md | 7.6 KB |
| evals/count-check-stayed-green-while-checkout-regressed/criteria.json | config | 6.8 KB |
| evals/count-check-stayed-green-while-checkout-regressed/task.md | markdown | 10.9 KB |
| evals/four-findings-we-never-fixed-are-reported-as-fixed/criteria.json | config | 6.7 KB |
| evals/four-findings-we-never-fixed-are-reported-as-fixed/task.md | markdown | 10.7 KB |
| evals/nightly-job-rewrites-the-list-every-morning/criteria.json | config | 6.5 KB |
| evals/nightly-job-rewrites-the-list-every-morning/task.md | markdown | 15.8 KB |
| evals/six-months-of-bugs-the-build-never-stopped/criteria.json | config | 8.0 KB |
| evals/six-months-of-bugs-the-build-never-stopped/task.md | markdown | 15.7 KB |
| evals/three-week-cleanup-that-never-moved-the-number/criteria.json | config | 6.1 KB |
| evals/three-week-cleanup-that-never-moved-the-number/task.md | markdown | 9.7 KB |
| references/gate-implementation.md | markdown | 2.4 KB |
references/gate-implementation.md
View on GitHub# a11y-violation-gate: scanner shapes and artifact template
Detail moved out of SKILL.md to keep the core gate script lean. The
runnable gate (axe-core ingestion) is in SKILL.md Step 3; extend it
to the other four scanners using the shapes below, then emit the PR
artifact with the template at the end of this file.
## Scanner native output shapes
| Scanner | Native output |
|------------------|-----------------------------------------------------------|
| axe-core | JSON with `violations[]`; rule ID, impact, nodes. |
| pa11y | JSON with `issues[]`; code (WCAG SC), type. |
| Lighthouse a11y | LHR JSON with `categories.accessibility.audits`. |
| WAVE | JSON via WebAIM API; `categories` with errors / warnings. |
| IBM Equal Access | JSON with `results[]`. |
## Normalizing the other scanners
Each scanner is read the same way as axe-core: pull its findings
array (the second column above), map its native fields onto the
unified record `{scanner, rule_id, wcag_sc, page_url, selector,
severity}`, and build the same fingerprint
`f"{scanner}::{rule_id}::{page_url}::{selector}"`. A finding whose
fingerprint reappears on the next run is the same violation; a new
fingerprint is a new violation.
## Full PR artifact template
Render for `$GITHUB_STEP_SUMMARY` or a PR comment:
```markdown
# A11y Gate - verdict: NO-GO
**Blockers (NEW violations): 2**
| Scanner | Rule | WCAG SC | Page | Selector | Severity |
|---------|-------------------|---------|--------------|---------------------|----------|
| axe | color-contrast | 1.4.3 | /checkout | button.primary | serious |
| axe | aria-required-attr | 4.1.2 | /checkout | div[role="dialog"] | critical |
**Warnings (NEW moderate): 1**
| Scanner | Rule | WCAG SC | Page | Selector |
|---------|---------------|---------|--------------|----------|
| pa11y | landmark-one-main | 1.3.1 | /checkout | (page-level) |
**Grandfathered (in baseline): 47**
**Fixed since baseline: 5** (positive trend)
## Recommended next step
Block-tier violations must be fixed in this PR. To address the
two blockers:
- `button.primary` on `/checkout`: contrast ratio 3.8:1; needs >=4.5:1.
- `div[role="dialog"]`: missing `aria-labelledby` or `aria-label`.
```
A no-go verdict exits non-zero so CI halts.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |