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

  1. Diff the PR (or current branch vs its merge base) for src/frontend/** changes.
  2. Map changed files → UI surfaces → routes / components / states to scan.
  3. Run both axe (Jest where applicable) and IBM Equal Access (Playwright page.runA11yScan and/or scripts/a11y/a11y_scan.py — see ibm-a11y-testing-guide / ibm-a11y-route-scan).
  4. 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).
  5. Re-scan until assert mode passes. Add/update a11y specs when coverage is missing.
  6. Report what changed, commands run, and any baselined/deferred debt.
Installs
4
GitHub Stars
154.9K
First Seen
Aug 18, 2026
ibm-a11y-pr-remediation — langflow-ai/langflow