scan-code-accessibility-figma — axe-core + JSDOM scan of HTML
Run axe-core (Deque's accessibility engine) against an HTML
string using JSDOM. This is the code side of the accessibility story: it checks the markup your
Figma-to-code workflow produced. It pairs with lint-design-figma (design side) to cover both ends.
Not a use_figma skill. This runs in plain Node — no Figma file, no Plugin API. axe-core owns the
rule database; this skill never invents rules.
Skill boundaries
- Design-side visual a11y (contrast, focus rings, target size, color-only) → use
lint-design-figma. Those rules are intentionally disabled here.
- Per-component design scorecard → use
audit-accessibility-figma.
- Design-vs-code parity → use
check-design-parity-figma (feed it the codeSpec.accessibility
this scan can emit).
- This skill does not use
use_figma, so the figma-use conventions do not apply.
Why visual rules are disabled
JSDOM provides a DOM but no layout engine and no computed visual styles — there is nothing to
measure pixels or rendered colors against. So axe's visual rules would always be "incomplete" or
wrong. The scan disables them explicitly:
color-contrast and color-contrast-enhanced — need rendered colors.link-in-text-block — needs surrounding text layout.target-size — needs rendered box dimensions.
Everything structural/semantic (ARIA, roles, names, labels, alt, headings, landmarks, lang, dup IDs,
tabindex, ~50 rules total) runs normally. For the visual half, run lint-design-figma on the design.
Usage
- Install deps once (in this skill's
scripts/ dir):cd scripts && npm install
Installs axe-core and jsdom.
- Run the scan against an HTML file or an inline string:
node scan.mjs path/to/component.html
node scan.mjs --html '<button>Save</button>'
Optional flags:
--tags wcag22aa — filter to a WCAG tag set (wcag2a, wcag2aa, wcag21aa, wcag22aa, best-practice). Repeatable / comma-separated.--context '#my-component' — scope the scan to a CSS selector.--include-passing — include counts of passing / incomplete / inapplicable rules.--map-to-codespec — also emit a codeSpecAccessibility object (semantic element, role, aria-label, focusVisible, keyboard interactions, disabled/error support) ready to drop into check-design-parity-figma's codeSpec.accessibility.
- Read the JSON on stdout: violations grouped by rule with
severity (critical/warning/info from
axe impact), wcagTags, helpUrl, and up to 10 offending nodes each, plus a summary.
A bare HTML fragment is auto-wrapped in <!DOCTYPE html><html lang="en">…<body>… before scanning.
Output shape
{
"engine": "axe-core", "version": "4.x", "mode": "jsdom-structural",
"note": "JSDOM mode: structural/semantic checks only. Visual rules disabled — use lint-design-figma.",
"categories": [ { "rule": "button-name", "severity": "critical", "count": 1, "description": "...", "wcagTags": ["wcag2a","wcag412"], "helpUrl": "...", "nodes": [ { "html": "...", "target": ["button"], "failureSummary": "..." } ] } ],
"summary": { "critical": 1, "warning": 0, "info": 0, "total": 1 }
}
Severity mapping: axe critical/serious → critical, moderate → warning, minor → info.
1---2name: scan-code-accessibility-figma3description: Scan generated/authored HTML for accessibility violations with axe-core (Deque) running over JSDOM — structural and semantic rules: ARIA attributes and roles, accessible names, alt text, form labels, heading order, landmarks, semantic HTML, tabindex, duplicate IDs, lang attribute, and ~50 more. Use on the CODE side of a Figma-to-code workflow: triggers 'scan this HTML for accessibility', 'run axe on my component', 'check the generated code for a11y', 'axe-core scan', 'accessibility lint my markup', 'WCAG check on code', 'is this HTML accessible'. This is a standalone Node script — NO Figma connection required. Visual rules (color-contrast, focus-visible, link-in-text-block, target-size) are DISABLED because JSDOM has no layout — use lint-design-figma for visual a11y on the design side. The two together give full design+code coverage.4---56# scan-code-accessibility-figma — axe-core + JSDOM scan of HTML78Run [axe-core](https://github.com/dequelabs/axe-core) (Deque's accessibility engine) against an HTML9string using JSDOM. This is the **code side** of the accessibility story: it checks the markup your10Figma-to-code workflow produced. It pairs with `lint-design-figma` (design side) to cover both ends.1112**Not a `use_figma` skill.** This runs in plain Node — no Figma file, no Plugin API. axe-core owns the13rule database; this skill never invents rules.1415## Skill boundaries16- **Design-side visual a11y** (contrast, focus rings, target size, color-only) → use17 `lint-design-figma`. Those rules are intentionally disabled here.18- **Per-component design scorecard** → use `audit-accessibility-figma`.19- **Design-vs-code parity** → use `check-design-parity-figma` (feed it the `codeSpec.accessibility`20 this scan can emit).21- This skill does **not** use `use_figma`, so the `figma-use` conventions do not apply.2223## Why visual rules are disabled2425JSDOM provides a DOM but **no layout engine and no computed visual styles** — there is nothing to26measure pixels or rendered colors against. So axe's visual rules would always be "incomplete" or27wrong. The scan disables them explicitly:2829- `color-contrast` and `color-contrast-enhanced` — need rendered colors.30- `link-in-text-block` — needs surrounding text layout.31- `target-size` — needs rendered box dimensions.3233Everything structural/semantic (ARIA, roles, names, labels, alt, headings, landmarks, lang, dup IDs,34tabindex, ~50 rules total) runs normally. For the visual half, run `lint-design-figma` on the design.3536## Usage37381. **Install deps once** (in this skill's `scripts/` dir):39 ```bash40 cd scripts && npm install41 ```42 Installs `axe-core` and `jsdom`.432. **Run the scan** against an HTML file or an inline string:44 ```bash45 node scan.mjs path/to/component.html46 node scan.mjs --html '<button>Save</button>'47 ```48 Optional flags:49 - `--tags wcag22aa` — filter to a WCAG tag set (`wcag2a`, `wcag2aa`, `wcag21aa`, `wcag22aa`, `best-practice`). Repeatable / comma-separated.50 - `--context '#my-component'` — scope the scan to a CSS selector.51 - `--include-passing` — include counts of passing / incomplete / inapplicable rules.52 - `--map-to-codespec` — also emit a `codeSpecAccessibility` object (semantic element, role, aria-label, focusVisible, keyboard interactions, disabled/error support) ready to drop into `check-design-parity-figma`'s `codeSpec.accessibility`.533. **Read the JSON** on stdout: violations grouped by rule with `severity` (critical/warning/info from54 axe `impact`), `wcagTags`, `helpUrl`, and up to 10 offending nodes each, plus a `summary`.5556A bare HTML fragment is auto-wrapped in `<!DOCTYPE html><html lang="en">…<body>…` before scanning.5758## Output shape5960```jsonc61{62 "engine": "axe-core", "version": "4.x", "mode": "jsdom-structural",63 "note": "JSDOM mode: structural/semantic checks only. Visual rules disabled — use lint-design-figma.",64 "categories": [ { "rule": "button-name", "severity": "critical", "count": 1, "description": "...", "wcagTags": ["wcag2a","wcag412"], "helpUrl": "...", "nodes": [ { "html": "...", "target": ["button"], "failureSummary": "..." } ] } ],65 "summary": { "critical": 1, "warning": 0, "info": 0, "total": 1 }66}67```6869Severity mapping: axe `critical`/`serious` → `critical`, `moderate` → `warning`, `minor` → `info`.
southleft