forms-errors-accessibility-audit

Audits web forms and error handling for accessible labels, validation, and WCAG 2.2 compliance.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/vmitsaras/Agent-Skills --skill forms-errors-accessibility-audit-vmitsaras
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: forms-errors-accessibility-audit
Source: https://github.com/vmitsaras/Agent-Skills/tree/main/skills/frontend-a11y/forms-errors-accessibility-audit
Command: npx skills add https://github.com/vmitsaras/Agent-Skills --skill forms-errors-accessibility-audit-vmitsaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web forms often fail users of assistive technology through missing labels, unclear error messages, lost data on failed submissions, and unannounced validation feedback. This Skill performs a structured, evidence-backed accessibility audit of forms and error handling so teams can find and fix these defects before users hit them. ## Core Features & Use Cases - Full form-journey audit: Reviews labels, instructions, required and invalid states, field groups, autocomplete, validation timing, error summaries, submission feedback, and recovery flows. - Evidence classification: Separates confirmed findings (with file, line, or reproduction evidence) from manual-test requirements for keyboard, screen-reader, and network behavior that cannot be verified statically. - WCAG 2.2 mapping: Maps each finding to relevant success criteria such as 1.3.1, 3.3.1, 3.3.3, and 4.1.3 without claiming full conformance. - Use Case: Before launching a checkout flow, run this audit to confirm every field has a programmatic label, errors identify the affected field with correction guidance, failed payments preserve entered values, and status messages are announced to screen readers. ## Quick Start Audit the sign-up and checkout forms in this repository for accessibility issues and produce a findings report with WCAG 2.2 mappings.

Frequently Asked Questions about forms-errors-accessibility-audit

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

FAQPage Schema
How do I audit a web form for accessibility issues?▼

Inventory every form state (initial, invalid, submitting, success, failure), then verify labels, instructions, required and invalid states, error identification, validation timing, keyboard behavior, and recovery. This Skill walks through each area and produces a structured findings report with WCAG 2.2 mappings.

How to check form error messages for screen reader accessibility?▼

Verify each error identifies the affected field in text, is programmatically associated with the field, and is announced via status messages or focus movement without relying on color alone. The audit separates confirmed code findings from announcements that require live screen-reader testing.

Does this audit prove WCAG 2.2 conformance?▼

No. The audit maps findings to relevant WCAG 2.2 criteria using wording like "maps to" or "requires verification against," but a scoped audit or automated scan never establishes full conformance. The report explicitly states this limitation.

Can the audit run without a live or runnable interface?▼

Yes. It audits whatever evidence exists, such as source code, templates, screenshots, or design briefs, and moves unverifiable behavior like focus management and screen-reader announcements into a manual-test requirements list with executable steps.

What are the limitations of automated form accessibility testing?▼

Automation confirms detectable defects like missing labels or invalid ARIA, but cannot infer keyboard operability, screen-reader announcement quality, or recovery behavior. Those checks are recorded as manual-test requirements with preconditions, steps, and expected accessible behavior.