archflow-agent-a11y-expert

Audits UI code against WCAG 2.1 AA and design-system accessibility anti-patterns.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-agent-a11y-expert-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-agent-a11y-expert
Source: https://github.com/AZidan/archflow/tree/main/adapters/generic/.agents/skills/archflow-agent-a11y-expert
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-agent-a11y-expert-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Accessibility violations in UI code often go unnoticed until late in development, and review findings shared only in chat messages get lost when sessions end. This Skill acts as an accessibility review gate that systematically audits code against WCAG 2.1 AA and the project's design system, then records every finding as a persistent, trackable issue. ## Core Features & Use Cases - WCAG 2.1 AA Compliance Audit: Evaluates HTML, CSS, JavaScript, and framework code against all Level A and AA success criteria, covering ARIA attributes, semantic markup, keyboard navigation, color contrast, and screen reader compatibility. - Design System Enforcement: Checks code against the anti-patterns, component vocabulary, and layout scales defined in .archflow/design-system.yaml, failing the review on any violation. - Persistent Issue Tracking: Writes every finding into the story's issues[] in the release YAML file and produces a verdict report at docs/a11y-reports/{story-id}-a11y.md opening with VERDICT: PASS or VERDICT: FAIL. - Use Case: After a UI engineer implements a new checkout form, dispatch this role to audit the markup for missing labels, focus management, and contrast issues, producing a report with file, line, and the exact fix for each violation. ## Quick Start Ask the agent to run an accessibility review of the current story's UI code against WCAG 2.1 AA and the project design system, then record all findings as issues.

Frequently Asked Questions about archflow-agent-a11y-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit UI code for WCAG 2.1 AA compliance?

Dispatch this role to review the code under test. It systematically checks all Level A and AA success criteria, including ARIA attributes, semantic markup, keyboard navigation, and color contrast, then reports each violation with file, line, and the fix.

How does the accessibility review gate decide pass or fail?

The audit treats the design system's anti-patterns section as a checklist, and any violation fails the review. Results are written to a report file opening with VERDICT: PASS or VERDICT: FAIL so the dispatching orchestrator can check the outcome.

What happens if the project has no design system configured?

If .archflow/design-system.yaml is missing and the project has a UI, the audit reports that as a blocking finding, since every screen becomes an independent guess without a defined design system.

Does the accessibility reviewer fix the violations it finds?

No. The role only reviews and records findings as issues in the release YAML file; it never fixes code, closes issues, or defers them. Fixes are landed by the implementation engineer, who sets the issue status.

What accessibility testing methods does the audit cover?

The review outlines testing with screen readers such as NVDA, JAWS, and VoiceOver, keyboard-only navigation scenarios, and color blindness and low vision checks, alongside automated tool recommendations and manual checklists.