accessibility-audit
What this is for
Find and fix the barriers that stop disabled people from using a web UI and its
content (pages, emails, PDFs and documents), and say truthfully how close it is
to the standard a user is held to: WCAG 2.2 AA, Section 508, ADA Title II or
III, or the EU's EN 301 549.
Accessibility isn't only an engineering problem. Whoever writes a page, an
email or a PDF is a content creator, and most barriers there (vague link text,
headings used for looks, a scanned PDF, a screenshot of text, dense legal prose)
are fixed in the words, not the code. This skill covers both.
The hard part is honesty, not finding bugs. Automated engines such as axe find
roughly a third to a half of real WCAG failures. The rest (focus order, whether
alt text is meaningful, whether an error message is announced, whether a flow
works by keyboard alone) needs a human or a careful manual pass. A clean axe run
means "no machine-detectable failures on the pages scanned", nothing more.
So the rules of this skill are:
- Never say "compliant" or "conformant" unless every success criterion in
scope was evaluated, including the manual ones, and passed. Say what was
checked, what passed, what failed, and what was Not Evaluated.
- Not legal advice. You can map findings to standards and say what a
regulation references. Whether an organization is legally exposed is a
question for counsel. Say so once, plainly, when the user asks about legal
compliance.
- Never recommend an overlay widget (a script that claims to make a site
accessible on load) as a fix. Overlays don't change the underlying markup.
Disabled users and advocacy groups widely oppose them, and they don't produce
conformance. If the site already ships one, audit with it disabled too.
Step 0: Pick the target standard
The user often names a law, not a standard. Map it, then audit against the
standard. WCAG 2.2 AA is a superset of 2.0 and 2.1 AA (except 4.1.1 Parsing,
which 2.2 removed), so auditing at 2.2 AA covers every row below. Tag each
finding with the version it first appears in, so a report can be cut to any of
them.
| The user says |
Audit against |
Notes |
| "Section 508", federal agency or contractor |
WCAG 2.0 A + AA, plus 508 chapters 3, 5 and 6 where they apply |
Revised 508 (36 CFR 1194) incorporates WCAG 2.0 AA by reference for web, documents and software. |
| ADA Title II (state and local government, public universities) |
WCAG 2.1 AA |
DOJ 2024 rule. Dates were pushed back by an April 2026 interim rule; see references/standards.md. |
| ADA Title III (businesses open to the public) |
WCAG 2.1 AA in practice, 2.2 AA advisable |
No technical regulation. Settlements and court orders usually name WCAG 2.1 AA. |
| EU, European Accessibility Act, EN 301 549 |
WCAG 2.1 AA (EN 301 549 clause 9) plus the EN extras |
EAA has applied since 2025-06-28. |
| "WCAG", "a11y", nothing specific |
WCAG 2.2 AA |
The current W3C recommendation. |
Regulatory dates change, and one is under litigation as of 2026-10. Before
quoting a deadline to the user, re-check the current date in
references/standards.md and say when it was last verified.
Step 1: Scope
Write down, before scanning:
- Pages and states. Not just routes. Also open modals, menus, error states,
empty states, logged-in views, and every step of the key flows (sign up,
checkout, search, submit). Most serious failures live in states, not in the
initial render.
- What you have. A running URL (full audit), source only (source pass plus
a runtime BLOCKED list), or both.
- Mode.
audit (find and report; the default), fix (audit, then remediate
and re-verify), gate (check a diff before it's called done), content
(review or rewrite copy, emails, PDFs and documents; Step 3b only), or
report (produce an ACR/VPAT draft from findings).
Step 2: Automated scan
With a running app and a shell, run the bundled scanner from the target
project's root, so it resolves that project's Playwright install:
node <skill-dir>/scripts/axe_scan.mjs \
--url http://localhost:3000/ --url http://localhost:3000/checkout \
--widths 1440,320 --standard wcag22aa
It runs axe-core on every URL at every width, checks 320px reflow (WCAG 1.4.10),
and writes .playwright/<run-id>/a11y/ with raw JSON per page, summary.json
and summary.md. Exit 0 means no violations at or above --fail-on (default
serious), 1 means violations, 2 means the scan could not run. Exit 2 is
never a clean pass. If the dependencies are missing, the script prints the
install command. Ask before installing them into the user's project.
axe also returns incomplete results: things it could not decide, such as
contrast over a background image. They go on the manual list, not into "passed".
To reach a state the URL alone doesn't open (a modal, a step 3), drive it with
the playwright skill, then inject axe on that page. The script's --help
shows the pattern. If only the Playwright MCP is available, inject axe-core
from its CDN build with browser_evaluate and run axe.run(). Same rules,
same report shape.
Step 3: Source pass
Run this pass whether or not the scan ran. It catches what a single render
misses, and it's the whole audit when there's no running app. Use the project's
linter first if it has one (eslint-plugin-jsx-a11y, eslint-plugin-vuejs-accessibility,
@angular-eslint template a11y rules) and report its findings with file:line.
Then grep for the high-yield patterns in references/fix-patterns.md:
click handlers on non-interactive elements, outline: none with no
replacement, positive tabindex, <img> without alt, inputs without labels,
aria-hidden on focusable content, and user-scalable=no.
Step 3b: Content pass
Read the words as well as the markup. Engineering checks can pass on a page
that still fails its readers. Work through references/content-design.md.
The high-yield checks:
- Plain language for a named audience. Who reads this, and what do they
need to do? Lead with that, use short sentences and common words, and define
jargon and legal terms with a concrete example. US federal public content is
required to be plain by the Plain Writing Act of 2010.
- Headings and lists that carry the structure. Headings mark the key points
in outline order. Lists separate items. Neither is chosen for looks.
- Link text that says where it goes. No "click here", "learn more" or bare
URLs as the visible text.
- Images that earn their place. Alt text conveys the purpose, decorative
images are dropped or marked
alt="", and text is never shared as a
screenshot (including in emails and social posts).
- Documents. PDFs are exported from a tagged source document, never scanned.
Better still, the content is published as an HTML page with the PDF as an
extra.
- No sensory-only instructions and no motion for decoration. No "the green
button on the right", and no looping GIFs or parallax.
Report content findings in the same shape as code findings, with the location
(page and section, or file:line for copy in source) and a suggested rewrite.
Rewrites go to the person who owns the copy. Agents propose them, and the
user decides. In content mode this pass is the whole job.
Step 4: Manual checks
Required for any statement about conformance, and the most valuable part of the
audit. Work through references/manual-checks.md. In short:
- Keyboard only. Every flow, start to finish, with Tab, Shift+Tab, Enter,
Space, Escape and the arrow keys. No traps. Focus is always visible and never
hidden behind a sticky header (2.4.11). Order follows the visual order.
- Names, roles, states. Read the accessibility tree
(
locator.ariaSnapshot() in Playwright, or the MCP's browser_snapshot).
Every control needs a meaningful name, the right role, and its state
(expanded, selected, invalid). Async changes are announced through a live
region.
- Zoom and reflow. 200% zoom with no loss of content. At 320 CSS px, no
horizontal scroll except on content that needs two dimensions, such as data
tables and maps. Text-spacing override (1.4.12) doesn't clip text.
- Color and contrast. Text 4.5:1 (3:1 for large text), and UI components
and focus indicators 3:1 (1.4.11). Information never carried by color alone.
- Forms and errors. Visible labels, errors identified in text and tied to
their field, required fields marked, no re-entering data already given
(3.3.7), and no cognitive puzzle to log in (3.3.8).
- Motion, media, time.
prefers-reduced-motion honored, nothing flashes
more than 3 times a second, captions and transcripts present, auto-playing
content can be paused, and time limits can be extended.
- Pointer. Targets at least 24×24 CSS px (2.5.8), every drag action has a
single-pointer alternative (2.5.7), and no action fires on press-down alone.
A real screen-reader pass (VoiceOver, NVDA, JAWS) is the strongest evidence.
An agent can't fully do it. Report it as Not Evaluated, needs a human with
, unless the user did it and told you the result.
Step 5: Triage and report findings
One finding per barrier, not per element. Group the 40 unlabeled icon buttons
into one finding with a count and a selector list.
### [Serious] Icon-only buttons have no accessible name — 1.1.1 / 4.1.2 (A)
- Where: `src/components/Toolbar.tsx:42`, 40 instances (`button.icon-btn`)
- Who it blocks: screen-reader users hear "button" with no purpose
- Evidence: axe `button-name`; aria snapshot shows `button` with no name
- Fix: add `aria-label="Delete row"` (or visible text); see fix-patterns §Names
Severity: Blocker, a user group can't complete a key task. Serious, a
task is possible but very hard, or a whole content type is lost. Moderate,
real friction with a workaround. Minor, a small deviation. Map axe impact
levels to these, but upgrade by context: a serious contrast failure on the
checkout button is a Blocker.
End every audit with this summary:
## Accessibility audit — <scope>, <date>
Standard: WCAG 2.2 AA (cuttable to 2.1 AA / 2.0 AA)
Pages and states covered: N (list)
Automated: axe <version>, N violations (B/S/M/m), N incomplete → manual list
Manual: keyboard ✓, names/roles ✓, zoom/reflow ✓, contrast ✓, forms ✓,
motion/media ✓, screen reader — Not Evaluated (needs human, NVDA/VoiceOver)
Verdict: Does not yet conform — N Blockers, N Serious. Not a legal opinion.
Step 6: Fix (fix mode)
Native HTML first, ARIA last: a <button> beats <div role="button" tabindex="0">
plus key handlers, because the native element brings focus, keyboard and
semantics for free. Use references/fix-patterns.md for the common fixes. Fix
at the shared component, not at each call site. After fixing, re-run the scan
and repeat the manual check that found the failure. The finding is closed only
when the re-check passes.
Never "fix" a finding by disabling the axe rule, adding aria-hidden to make a
control disappear from the tree, or adding role="presentation" to silence a
warning. Those hide the barrier from the tool and leave it in place for the user.
Color fixes go through the design tokens. Change the token, not the component,
and let design-token-guard confirm no literal was inlined.
Step 7: Conformance report (report mode)
For an ACR (Accessibility Conformance Report) built on the ITI VPAT template,
follow references/conformance-report.md. Use the VPAT edition that matches the
buyer: 508, EU (EN 301 549), WCAG, or INT for all of them. Every criterion gets
Supports, Partially Supports, Does Not Support, Not Applicable,
or Not Evaluated, with remarks that name the failing component. Mark it a
draft for human review. An ACR is a vendor's legal representation, and an
agent-drafted one must be checked by someone accountable for it.
Gate mode (before UI work is called done)
For a diff, run Step 3 on the changed files and Step 2 on the pages they
render, then do the keyboard and names checks from Step 4 on any changed
interactive component. Blockers and Serious findings in the diff mean not
done. Report pre-existing issues outside the diff separately. Don't block the
change on them.
When the tools can't run
- Shell, no browser or deps: source pass (Step 3) plus a static read for
labels, alt text, heading order and landmarks. Every runtime check (contrast
on rendered colors, reflow, focus visibility, keyboard flow) goes on a
BLOCKED — needs a running app list.
- No shell, file read only: the same source pass with grep and read tools.
- Nothing readable: give the plan (scope, standard, checks) and mark every
result Not Evaluated. Don't infer pass from absence of evidence.
How it composes
- frontend-agent builds to its Accessibility rule and runs gate mode before
reporting done.
- qe-agent runs audit mode on the running app in integration verification
and puts the summary in its QA report. Blockers are CRITICAL.
- ui-brief §8 names the target standard. This skill is how the definition
of done is checked.
- ux-review looks at the overall experience. This skill goes deeper on
accessibility and the standards, and ux-review defers here for compliance
questions.
- playwright supplies the browser, the state-driving and the
.playwright/<run-id>/ layout.
- render-sanity and design-token-guard stay narrow and send a11y work
here.
References
references/standards.md: WCAG 2.2 AA criteria by version, Section 508
chapters, ADA Title II and III status with last-verified dates, and EN 301 549/EAA.
references/manual-checks.md: step-by-step manual procedures, with pass and
fail evidence for each.
references/fix-patterns.md: grep patterns for the source pass and the
standard fix for each common failure.
references/content-design.md: plain language, headings, links, images,
emails, PDFs and documents, and testing content with disabled users.
references/conformance-report.md: how to fill in an ACR/VPAT honestly.
scripts/axe_scan.mjs: the Playwright + axe-core scanner. Run --help for
flags.
1---2name: accessibility-audit3version: 1.0.04composes_with:5 [6 "frontend-agent",7 "qe-agent",8 "playwright",9 "ux-review",10 "ui-brief",11 "render-sanity",12 "design-token-guard",13 "code-review-agent",14 "orchestrator",15 ]16description: >-17 Audit and fix web accessibility against WCAG 2.2 AA, Section 508 and the ADA:18 axe scan, keyboard, screen-reader and zoom checks, plain-language content and19 PDFs, source fixes, and an honest conformance report (ACR/VPAT draft). Use for20 any a11y review, fix or compliance question. Trigger on "accessibility21 audit", "is this ADA compliant", "Section 508", "WCAG", "VPAT", "a11y".22compatibility: Read/edit/shell host; the scanner needs Node 18+ with playwright and @axe-core/playwright in the target project. Degrades to a source-only pass without them.23allowed-tools: ["Bash", "Read", "Write", "Edit", "Glob", "Grep"]24metadata:25 source: https://skillmd.com/skills/ivy00johns/accessibility-audit26---2728# accessibility-audit2930## What this is for3132Find and fix the barriers that stop disabled people from using a web UI and its33content (pages, emails, PDFs and documents), and say truthfully how close it is34to the standard a user is held to: WCAG 2.2 AA, Section 508, ADA Title II or35III, or the EU's EN 301 549.3637Accessibility isn't only an engineering problem. Whoever writes a page, an38email or a PDF is a content creator, and most barriers there (vague link text,39headings used for looks, a scanned PDF, a screenshot of text, dense legal prose)40are fixed in the words, not the code. This skill covers both.4142The hard part is honesty, not finding bugs. Automated engines such as axe find43roughly a third to a half of real WCAG failures. The rest (focus order, whether44alt text is meaningful, whether an error message is announced, whether a flow45works by keyboard alone) needs a human or a careful manual pass. A clean axe run46means "no machine-detectable failures on the pages scanned", nothing more.47So the rules of this skill are:4849- **Never say "compliant" or "conformant"** unless every success criterion in50 scope was evaluated, including the manual ones, and passed. Say what was51 checked, what passed, what failed, and what was **Not Evaluated**.52- **Not legal advice.** You can map findings to standards and say what a53 regulation references. Whether an organization is legally exposed is a54 question for counsel. Say so once, plainly, when the user asks about legal55 compliance.56- **Never recommend an overlay widget** (a script that claims to make a site57 accessible on load) as a fix. Overlays don't change the underlying markup.58 Disabled users and advocacy groups widely oppose them, and they don't produce59 conformance. If the site already ships one, audit with it disabled too.6061## Step 0: Pick the target standard6263The user often names a law, not a standard. Map it, then audit against the64standard. WCAG 2.2 AA is a superset of 2.0 and 2.1 AA (except 4.1.1 Parsing,65which 2.2 removed), so auditing at 2.2 AA covers every row below. Tag each66finding with the version it first appears in, so a report can be cut to any of67them.6869| The user says | Audit against | Notes |70| -------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |71| "Section 508", federal agency or contractor | WCAG 2.0 A + AA, plus 508 chapters 3, 5 and 6 where they apply | Revised 508 (36 CFR 1194) incorporates WCAG 2.0 AA by reference for web, documents and software. |72| ADA Title II (state and local government, public universities) | WCAG 2.1 AA | DOJ 2024 rule. Dates were pushed back by an April 2026 interim rule; see `references/standards.md`. |73| ADA Title III (businesses open to the public) | WCAG 2.1 AA in practice, 2.2 AA advisable | No technical regulation. Settlements and court orders usually name WCAG 2.1 AA. |74| EU, European Accessibility Act, EN 301 549 | WCAG 2.1 AA (EN 301 549 clause 9) plus the EN extras | EAA has applied since 2025-06-28. |75| "WCAG", "a11y", nothing specific | WCAG 2.2 AA | The current W3C recommendation. |7677Regulatory dates change, and one is under litigation as of 2026-10. Before78quoting a deadline to the user, re-check the current date in79`references/standards.md` and say when it was last verified.8081## Step 1: Scope8283Write down, before scanning:8485- **Pages and states.** Not just routes. Also open modals, menus, error states,86 empty states, logged-in views, and every step of the key flows (sign up,87 checkout, search, submit). Most serious failures live in states, not in the88 initial render.89- **What you have.** A running URL (full audit), source only (source pass plus90 a runtime BLOCKED list), or both.91- **Mode.** `audit` (find and report; the default), `fix` (audit, then remediate92 and re-verify), `gate` (check a diff before it's called done), `content`93 (review or rewrite copy, emails, PDFs and documents; Step 3b only), or94 `report` (produce an ACR/VPAT draft from findings).9596## Step 2: Automated scan9798With a running app and a shell, run the bundled scanner from the target99project's root, so it resolves that project's Playwright install:100101```bash102node <skill-dir>/scripts/axe_scan.mjs \103 --url http://localhost:3000/ --url http://localhost:3000/checkout \104 --widths 1440,320 --standard wcag22aa105```106107It runs axe-core on every URL at every width, checks 320px reflow (WCAG 1.4.10),108and writes `.playwright/<run-id>/a11y/` with raw JSON per page, `summary.json`109and `summary.md`. Exit 0 means no violations at or above `--fail-on` (default110`serious`), 1 means violations, 2 means the scan could not run. **Exit 2 is111never a clean pass.** If the dependencies are missing, the script prints the112install command. Ask before installing them into the user's project.113114axe also returns **incomplete** results: things it could not decide, such as115contrast over a background image. They go on the manual list, not into "passed".116117To reach a state the URL alone doesn't open (a modal, a step 3), drive it with118the `playwright` skill, then inject axe on that page. The script's `--help`119shows the pattern. If only the Playwright MCP is available, inject axe-core120from its CDN build with `browser_evaluate` and run `axe.run()`. Same rules,121same report shape.122123## Step 3: Source pass124125Run this pass whether or not the scan ran. It catches what a single render126misses, and it's the whole audit when there's no running app. Use the project's127linter first if it has one (`eslint-plugin-jsx-a11y`, `eslint-plugin-vuejs-accessibility`,128`@angular-eslint` template a11y rules) and report its findings with `file:line`.129Then grep for the high-yield patterns in `references/fix-patterns.md`:130click handlers on non-interactive elements, `outline: none` with no131replacement, positive `tabindex`, `<img>` without `alt`, inputs without labels,132`aria-hidden` on focusable content, and `user-scalable=no`.133134## Step 3b: Content pass135136Read the words as well as the markup. Engineering checks can pass on a page137that still fails its readers. Work through `references/content-design.md`.138The high-yield checks:139140- **Plain language for a named audience.** Who reads this, and what do they141 need to do? Lead with that, use short sentences and common words, and define142 jargon and legal terms with a concrete example. US federal public content is143 required to be plain by the Plain Writing Act of 2010.144- **Headings and lists that carry the structure.** Headings mark the key points145 in outline order. Lists separate items. Neither is chosen for looks.146- **Link text that says where it goes.** No "click here", "learn more" or bare147 URLs as the visible text.148- **Images that earn their place.** Alt text conveys the purpose, decorative149 images are dropped or marked `alt=""`, and text is never shared as a150 screenshot (including in emails and social posts).151- **Documents.** PDFs are exported from a tagged source document, never scanned.152 Better still, the content is published as an HTML page with the PDF as an153 extra.154- **No sensory-only instructions and no motion for decoration.** No "the green155 button on the right", and no looping GIFs or parallax.156157Report content findings in the same shape as code findings, with the location158(page and section, or `file:line` for copy in source) and a suggested rewrite.159Rewrites go to the person who owns the copy. Agents propose them, and the160user decides. In `content` mode this pass is the whole job.161162## Step 4: Manual checks163164Required for any statement about conformance, and the most valuable part of the165audit. Work through `references/manual-checks.md`. In short:1661671. **Keyboard only.** Every flow, start to finish, with Tab, Shift+Tab, Enter,168 Space, Escape and the arrow keys. No traps. Focus is always visible and never169 hidden behind a sticky header (2.4.11). Order follows the visual order.1702. **Names, roles, states.** Read the accessibility tree171 (`locator.ariaSnapshot()` in Playwright, or the MCP's `browser_snapshot`).172 Every control needs a meaningful name, the right role, and its state173 (expanded, selected, invalid). Async changes are announced through a live174 region.1753. **Zoom and reflow.** 200% zoom with no loss of content. At 320 CSS px, no176 horizontal scroll except on content that needs two dimensions, such as data177 tables and maps. Text-spacing override (1.4.12) doesn't clip text.1784. **Color and contrast.** Text 4.5:1 (3:1 for large text), and UI components179 and focus indicators 3:1 (1.4.11). Information never carried by color alone.1805. **Forms and errors.** Visible labels, errors identified in text and tied to181 their field, required fields marked, no re-entering data already given182 (3.3.7), and no cognitive puzzle to log in (3.3.8).1836. **Motion, media, time.** `prefers-reduced-motion` honored, nothing flashes184 more than 3 times a second, captions and transcripts present, auto-playing185 content can be paused, and time limits can be extended.1867. **Pointer.** Targets at least 24×24 CSS px (2.5.8), every drag action has a187 single-pointer alternative (2.5.7), and no action fires on press-down alone.188189A real screen-reader pass (VoiceOver, NVDA, JAWS) is the strongest evidence.190An agent can't fully do it. Report it as **Not Evaluated, needs a human with191<reader>**, unless the user did it and told you the result.192193## Step 5: Triage and report findings194195One finding per barrier, not per element. Group the 40 unlabeled icon buttons196into one finding with a count and a selector list.197198```markdown199### [Serious] Icon-only buttons have no accessible name — 1.1.1 / 4.1.2 (A)200201- Where: `src/components/Toolbar.tsx:42`, 40 instances (`button.icon-btn`)202- Who it blocks: screen-reader users hear "button" with no purpose203- Evidence: axe `button-name`; aria snapshot shows `button` with no name204- Fix: add `aria-label="Delete row"` (or visible text); see fix-patterns §Names205```206207Severity: **Blocker**, a user group can't complete a key task. **Serious**, a208task is possible but very hard, or a whole content type is lost. **Moderate**,209real friction with a workaround. **Minor**, a small deviation. Map axe impact210levels to these, but upgrade by context: a `serious` contrast failure on the211checkout button is a Blocker.212213End every audit with this summary:214215```markdown216## Accessibility audit — <scope>, <date>217218Standard: WCAG 2.2 AA (cuttable to 2.1 AA / 2.0 AA)219Pages and states covered: N (list)220Automated: axe <version>, N violations (B/S/M/m), N incomplete → manual list221Manual: keyboard ✓, names/roles ✓, zoom/reflow ✓, contrast ✓, forms ✓,222motion/media ✓, screen reader — Not Evaluated (needs human, NVDA/VoiceOver)223Verdict: Does not yet conform — N Blockers, N Serious. Not a legal opinion.224```225226## Step 6: Fix (fix mode)227228Native HTML first, ARIA last: a `<button>` beats `<div role="button" tabindex="0">`229plus key handlers, because the native element brings focus, keyboard and230semantics for free. Use `references/fix-patterns.md` for the common fixes. Fix231at the shared component, not at each call site. After fixing, re-run the scan232and repeat the manual check that found the failure. The finding is closed only233when the re-check passes.234235Never "fix" a finding by disabling the axe rule, adding `aria-hidden` to make a236control disappear from the tree, or adding `role="presentation"` to silence a237warning. Those hide the barrier from the tool and leave it in place for the user.238239Color fixes go through the design tokens. Change the token, not the component,240and let `design-token-guard` confirm no literal was inlined.241242## Step 7: Conformance report (report mode)243244For an ACR (Accessibility Conformance Report) built on the ITI VPAT template,245follow `references/conformance-report.md`. Use the VPAT edition that matches the246buyer: 508, EU (EN 301 549), WCAG, or INT for all of them. Every criterion gets247**Supports**, **Partially Supports**, **Does Not Support**, **Not Applicable**,248or **Not Evaluated**, with remarks that name the failing component. Mark it a249**draft for human review**. An ACR is a vendor's legal representation, and an250agent-drafted one must be checked by someone accountable for it.251252## Gate mode (before UI work is called done)253254For a diff, run Step 3 on the changed files and Step 2 on the pages they255render, then do the keyboard and names checks from Step 4 on any changed256interactive component. Blockers and Serious findings in the diff mean not257done. Report pre-existing issues outside the diff separately. Don't block the258change on them.259260## When the tools can't run261262- **Shell, no browser or deps:** source pass (Step 3) plus a static read for263 labels, alt text, heading order and landmarks. Every runtime check (contrast264 on rendered colors, reflow, focus visibility, keyboard flow) goes on a265 **BLOCKED — needs a running app** list.266- **No shell, file read only:** the same source pass with grep and read tools.267- **Nothing readable:** give the plan (scope, standard, checks) and mark every268 result **Not Evaluated**. Don't infer pass from absence of evidence.269270## How it composes271272- **frontend-agent** builds to its Accessibility rule and runs gate mode before273 reporting done.274- **qe-agent** runs audit mode on the running app in integration verification275 and puts the summary in its QA report. Blockers are CRITICAL.276- **ui-brief** §8 names the target standard. This skill is how the definition277 of done is checked.278- **ux-review** looks at the overall experience. This skill goes deeper on279 accessibility and the standards, and ux-review defers here for compliance280 questions.281- **playwright** supplies the browser, the state-driving and the282 `.playwright/<run-id>/` layout.283- **render-sanity** and **design-token-guard** stay narrow and send a11y work284 here.285286## References287288- `references/standards.md`: WCAG 2.2 AA criteria by version, Section 508289 chapters, ADA Title II and III status with last-verified dates, and EN 301 549/EAA.290- `references/manual-checks.md`: step-by-step manual procedures, with pass and291 fail evidence for each.292- `references/fix-patterns.md`: grep patterns for the source pass and the293 standard fix for each common failure.294- `references/content-design.md`: plain language, headings, links, images,295 emails, PDFs and documents, and testing content with disabled users.296- `references/conformance-report.md`: how to fill in an ACR/VPAT honestly.297- `scripts/axe_scan.mjs`: the Playwright + axe-core scanner. Run `--help` for298 flags.