ibm-a11y-pr-remediation
Installation
SKILL.md
IBM Level 1 PR Accessibility Remediation
Scope is IBM Equal Access Level 1 only. Default mode is fix, not report-only. Scan every frontend surface touched by the PR/branch and remediate all in-scope issues until both engines are green (or only documented baselines remain).
This skill is a PR-scoped orchestrator. It does not duplicate detailed engine/pattern guidance — read the linked skills for that:
- ibm-a11y-testing-guide — which engine/test layer to use, POUR checklist, axe-vs-IBM gaps, Radix/AG-Grid gotchas, baselines.
- ibm-a11y-route-scan — Python scanner options for ad-hoc route batches.
- ibm-a11y-level1-audit — Level 1 criteria references and report template, useful when the user wants a formal audit report for the PR instead of (or in addition to) fixes.
- frontend-i18n — accessible names / UI strings must go through i18n.
Mandate
- Diff the PR (or current branch vs its merge base) for
src/frontend/**changes. - Map changed files → UI surfaces → routes / components / states to scan.
- Run both axe (Jest where applicable) and IBM Equal Access (Playwright
page.runA11yScanand/orscripts/a11y/a11y_scan.py— seeibm-a11y-testing-guide/ibm-a11y-route-scan). - Fix every in-scope Level 1 violation in the changed surfaces. Do not stop at a findings list unless the user says report only (in that case, hand off to
ibm-a11y-level1-audit). - Re-scan until assert mode passes. Add/update a11y specs when coverage is missing.
- Report what changed, commands run, and any baselined/deferred debt.