nmor/the-claude-council/accessible-forms
Claude Code and agent skill by nmor/the-claude-council
- community
Checking that the SKILL.md file is still in the repository.
Production form accessibility — labels, errors, autocomplete, validation timing, multi-step flows, file inputs, date pickers, and the WCAG 2.2 Redundant Entry + Accessible Authentication SCs.
Install
npx vskill@latest install nmor/the-claude-council/accessible-formsSKILL.md
The same SKILL.md was published earlier as nmor/the-claude-council/accessible-forms.
Accessible Forms
Size budget: 20 KB —token-budget.mjs --check.
The form is where accessibility most often breaks. Visual designers prioritise clean layouts; engineers reach for placeholder as a label; validation surfaces errors at submit; keyboard users get trapped in modal flows; screen-reader users discover required fields after submission. This skill encodes the patterns that pass real audits.
Purpose
Forms are conversion-critical (signup, checkout, contact, KYC) AND accessibility-critical (auth, payment, account management are AAA paths per wcag-accessibility). The patterns below cover every input type, every state transition, every validation pattern, and the two new WCAG 2.2 SCs that specifically target authentication forms.
Standards Cited
- WCAG 2.2 §1.3.1 — Info and Relationships (label association)
- WCAG 2.2 §1.3.5 — Identify Input Purpose (autocomplete tokens)
- WCAG 2.2 §2.4.6 — Headings and Labels (descriptive)
- WCAG 2.2 §3.3.1 — Error Identification
- WCAG 2.2 §3.3.2 — Labels or Instructions
- WCAG 2.2 §3.3.3 — Error Suggestion
- WCAG 2.2 §3.3.4 — Error Prevention (Legal, Financial, Data)
- WCAG 2.2 §3.3.7 — Redundant Entry (NEW in 2.2)
- WCAG 2.2 §3.3.8 — Accessible Authentication Minimum (NEW in 2.2)
- WCAG 2.2 §3.3.9 — Accessible Authentication Enhanced (NEW in 2.2)
- HTML Living Standard —
<label>,<input>,autocompleteattribute, constraint validation
API
- WAI-ARIA 1.2 —
aria-required,aria-invalid,aria-describedby,aria-errormessage - WHATWG Autocomplete tokens —
username,current-password,new-password,one-time-code,
email, etc.
When to Fire
- Any
<form>,<input>,<select>,<textarea>,<button type="submit"> - Any signup / login / password reset / 2FA flow
- Any checkout / billing / payment flow
- Any KYC / identity verification flow
- Any multi-step wizard
- Any inline editing pattern (double-click to edit, etc.)
Core Patterns
Every input has a real <label>
When the label must be visually hidden (e.g., search input in a header), use the sr-only pattern — NOT aria-label (which loses the visible label when AT switches to braille / sound only):
Autocomplete tokens (WCAG 1.3.5)
Browsers + password managers + autofill need to identify input purpose. Use the WHATWG token list:
Disabling autocomplete (autocomplete="off") on auth fields fails WCAG 1.3.5 AND fights password managers — banned outside narrow cases (e.g., shared kiosk).
Validation timing — three correct moments
- On blur for format checks ("Invalid email") — debounce 300ms; don't fire while user is typing
- On change for cross-field checks ("Passwords don't match") — only after both fields blurred
once
- On submit for server-side checks (email unique, payment authorised)
Banned:
- On every keystroke — user types one character, sees "Required" — destroys flow
- Only on submit — user fills form, submits, sees 8 errors — has to scroll back through
Error patterns (ARIA-anchored)
aria-invalid="true"flips when the field is invalid; flip back to"false"once correctedaria-describedbyjoins multiple ids (hint + error); the error message reads on focusrole="alert"announces the error immediately when it appears (usearia-live="polite"if the
error should NOT interrupt — e.g., for non-blocking warnings)
Error message content
| Wrong | Right | |
|---|---|---|
| "Invalid" | "Enter a valid email address — e.g., <name@example.com>" | |
| "Field required" | "Enter your full legal name" | |
| "Must be 8+ characters" | "Use 12+ characters including a number and a symbol" | |
| "Password too weak" | "Add a number, a symbol, and increase length to 12+" | |
| Red border, no text | Red border + text describing what's wrong + how to fix |
WCAG 3.3.3 — error messages MUST suggest a fix when feasible.
WCAG 3.3.7 — Redundant Entry
The user enters info ONCE per session. If you need confirmation, SHOW + allow edit; don't re-type.
WCAG 3.3.8 — Accessible Authentication
Cognitive function tests (memorising passwords, solving puzzles, transcribing characters) must have an accessible alternative:
| Auth method | 3.3.8 (AA) status | |
|---|---|---|
| Password | ✅ if password managers ALLOWED (don't block paste; honour autocomplete) | |
| Password manager | ✅ canonical accessible alternative | |
| Magic link | ✅ no memorisation required | |
| Passkey / WebAuthn | ✅ device authentication | |
| Biometric (Touch ID / Face ID) | ✅ no cognitive test | |
| SMS OTP | ✅ if user can copy-paste the code | |
| TOTP (Google Authenticator) | ⚠️ AA-passing if user can copy-paste; AAA needs alternative | |
| CAPTCHA (text recognition) | ❌ FAILS 3.3.8 AA without alternative | |
| Image puzzles ("find the bus") | ❌ FAILS unless alternative offered | |
| Math problems | ❌ FAILS |
If you ship a CAPTCHA, provide an accessible alternative (audio CAPTCHA, email link, support contact).
Required vs optional
NEVER use only color (red border) to indicate required — WCAG 1.4.1.
<fieldset> + <legend> for grouped inputs
Screen readers announce the legend before each input within the fieldset — context for what the field belongs to.
Multi-step forms
- Show progress: "Step 2 of 4 — Billing details"
- Each step has its own
<h1>or<h2>(focus moves on step transition) - Allow back navigation; preserve already-entered data
- Save draft state if the form is long
- Use
aria-current="step"on the active progress indicator
File inputs
After upload, announce the filename via aria-live:
Date pickers
Native <input type="date"> is accessible by default. Custom date pickers (React DayPicker, etc.) MUST implement the APG dialog + grid keyboard model:
- Arrow keys move between days
- Page Up / Page Down = month
- Shift + Page Up / Page Down = year
- Home / End = start / end of week
- Esc closes
- Enter selects
If you ship a custom picker, also provide a typed input fallback: "Or type the date as YYYY-MM-DD".
Submit button states
| State | Pattern | |
|---|---|---|
| Idle | <button type="submit">Submit</button> | |
| Submitting | <button type="submit" disabled aria-busy="true">Submitting…</button> | |
| After error | Re-enable; focus the first invalid field; announce "Form has errors" via role="alert" | |
| After success | Navigate to success page OR show inline success with focus moved to it |
Banned: spinner that spins forever with no announcement.
Anti-Patterns
Anti-pattern 1: Placeholder as label
Placeholders disappear when the field has a value. Users with cognitive disabilities, ADHD, or simply tabbing back to verify lose the field's purpose. Always use a real <label>.
Anti-pattern 2: Disabling form fields without explanation
<input disabled> is invisible to most screen readers OR announced confusingly. If a field is conditionally available, prefer hiding it entirely (with aria-live announcing the change) or showing it readonly with explanation: "Country: United States (set during signup; contact support to change)".
Anti-pattern 3: Errors at the top of the form only
Inline errors per-field are more actionable. If you ALSO show a summary, link from the summary to each field via <a href="#field-id">.
Anti-pattern 4: Custom checkboxes without :checked state
Anti-pattern 5: Honeypot fields without aria-hidden
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 98 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/accessible-forms/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/nmor/the-claude-council/accessible-forms)