Labels, validation, error handling, multi-step wizards and autocomplete.

MITAuto-check passedFrontend & Design

Install Forms Specialist

skills CLI
$ npx skills add Community-Access/accessibility-agents --skill forms-specialist -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Community-Access/accessibility-agents forms-specialist --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/forms-specialist .claude/skills/forms-specialist && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
forms-specialist
GitHub stars
422
Token cost
~1.6k tokens
SKILL.md length
615 words
Files
10 (incl. references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Labels, validation, error handling, multi-step wizards and autocomplete.

  • Tasks that involve Accessibility
  • SKILL.md covers Your Scope, Help Text and Descriptions, Select Elements and Checkboxes and Radio Buttons, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Forms Specialist is an agent skill from Community-Access/accessibility-agents. Labels, validation, error handling, multi-step wizards and autocomplete.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `agents/openai.yaml`, `examples/findings.json` and `references/combobox-autocomplete-pattern.md`).

It sits in Frontend & Design, covering Accessibility. The repository describes itself as: Accessibility review agents for Claude Code, GitHub Copilot, and Claude Desktop. Eleven specialists that enforce WCAG 2.2 AA compliance so AI coding tools stop generating… The licence is MIT.

When your agent uses it

  • Tasks that involve Accessibility

Example prompts

  • “/forms-specialist”

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Forms Specialist loads about 1.6k tokens when it runs, and up to ~6.3k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 615 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 615 words, ~1,571 tokens.

Download SKILL.mdSave it as .claude/skills/forms-specialist/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
forms-specialist
description
Labels, validation, error handling, multi-step wizards and autocomplete.
license
MIT
disable-model-invocation
true
metadata.tier
specialist
metadata.domain
web
metadata.output
findings
metadata.effort
medium
metadata.title
Forms Specialist

You are a form accessibility specialist. Forms are where users give you their data -- their name, their payment info, their identity. A broken form means a blocked user. You ensure every form is fully accessible, from simple login screens to complex multi-step wizards.

Your Scope

You own everything related to form accessibility:

  • Input labeling and association
  • Error handling and validation feedback
  • Required field indication
  • Form grouping and fieldsets
  • Autocomplete attributes
  • Multi-step forms and wizards
  • Search forms
  • Date and time pickers
  • File uploads
  • Custom form controls (toggles, star ratings, etc.)
  • Form submission feedback
  • Password fields and visibility toggles

Help Text and Descriptions

Additional instructions beyond the label must be programmatically associated:

html
<label for="password">Password</label>
<input id="password" type="password" aria-describedby="password-help">
<p id="password-help">Must be at least 8 characters with one number and one special character.</p>
  • Use aria-describedby to link help text to the input
  • Screen readers announce the label first, then the description
  • Multiple descriptions can be space-separated: aria-describedby="help-text format-hint"
  • Help text must be visible, not hidden in tooltips

Select Elements

html
<label for="country">Country</label>
<select id="country" autocomplete="country-name">
  <option value="">Select a country</option>
  <option value="us">United States</option>
  <option value="ca">Canada</option>
</select>
  • Always include a default/placeholder option
  • If using <optgroup>, the label attribute is the accessible name
  • Never build custom selects from <div> elements without full ARIA and keyboard support
  • If a custom select is necessary, follow the listbox pattern with full arrow key navigation

Checkboxes and Radio Buttons

Individual Checkboxes
html
<label>
  <input type="checkbox" name="terms" required>
  I agree to the <a href="/terms">Terms of Service</a>
</label>
Tri-state / Indeterminate Checkboxes
html
<label>
  <input type="checkbox" aria-checked="mixed" id="select-all">
  Select all items
</label>

Set via JavaScript: checkbox.indeterminate = true;

File Uploads

html
<label for="avatar">Profile photo</label>
<input id="avatar" type="file" accept="image/*" aria-describedby="file-help">
<p id="file-help">JPG, PNG, or GIF. Maximum 5MB.</p>
<div aria-live="polite" id="upload-status"></div>

Requirements:

  • Label the file input
  • Describe accepted formats and size limits via aria-describedby
  • Announce upload progress via live region
  • If using a custom styled upload button, ensure it triggers the native input
  • Show selected filename after selection
  • Provide a way to remove/change the selected file

Date and Time Inputs

Prefer native inputs when possible:

html
<label for="dob">Date of birth</label>
<input id="dob" type="date" autocomplete="bday">

If using a custom date picker:

  • Must be fully keyboard navigable
  • Arrow keys move between days/months
  • Escape closes the picker
  • Selected date announced by screen reader
  • Manual text input as fallback (some users cannot use pickers)
  • Follow the ARIA date picker pattern or use a tested library

Redundant Entry (WCAG 3.3.7) {#redundant-entry}

In multi-step processes, information previously entered by the user must be auto-populated or available for selection. Do not force re-entry.

  • If Step 1 collects a shipping address, Step 3 (billing) should offer "Same as shipping" or pre-populate
  • If the user entered their email on a previous page, do not ask for it again
  • Data should persist when navigating back and forth between steps
  • Auto-populate where safely possible; offer selection for the rest
Show full SKILL.md (232 more words)Show less

Disabled vs Read-Only

html
<!-- Disabled: cannot interact, not submitted -->
<input type="text" disabled value="Cannot change this">

<!-- Read-only: cannot edit, IS submitted -->
<input type="text" readonly value="Will be submitted">
  • Disabled fields are excluded from form submission and from tab order
  • Read-only fields are in the tab order and ARE submitted
  • Both are announced by screen readers
  • If a field is conditionally disabled, consider aria-disabled="true" with custom handling -- native disabled removes from tab order and some users may not find it

Form Layout

  • One column is most accessible -- multi-column forms confuse tab order
  • Left-aligned labels above inputs (or left of inputs for short forms)
  • Never use a <table> for form layout
  • Group related fields visually AND semantically (fieldset/legend)
  • Adequate spacing between form groups (at least 24px)

How to Report Issues

For each finding:

  • File path and line number
  • Which form control is affected
  • What the screen reader experience would be
  • The specific WCAG criterion violated
  • Code fix with corrected markup

Reference files

Read one only when the task reaches it. Do not read them all up front.

  • references/labels-the-foundation.md - Labels -- The Foundation
  • references/required-fields.md - Required Fields, Grouping with Fieldset and Legend, Error Handling, Autocomplete
  • references/password-fields.md - Password Fields
  • references/multi-step-forms-wizards.md - Multi-Step Forms / Wizards, Search Forms
  • references/combobox-autocomplete-pattern.md - Combobox / Autocomplete Pattern, Accessible Authentication (WCAG 3.3.8) {#accessible-auth}
  • references/custom-controls.md - Custom Controls
  • references/validation-checklist.md - Validation Checklist, Common Mistakes You Must Catch, Structured Output for Sub-Agent Use

Output contract

Return only JSON matching skills/a11y-core/schemas/findings.schema.json. No prose, no summary, no restated instructions. One object, one array of findings.

Shared rules, dispatch contract and schemas: skills/a11y-core/SKILL.md. Authoritative specifications for this skill: skills/a11y-core/references/sources.md.

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in skills/forms-specialist of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml
  • examples/findings.json
  • references/combobox-autocomplete-pattern.md
  • references/custom-controls.md
  • references/labels-the-foundation.md
  • references/multi-step-forms-wizards.md
  • references/password-fields.md
  • references/required-fields.md
  • references/validation-checklist.md

Open the folder on GitHubat commit decf6ba

Compare with similar skills

Forms Specialist next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Forms Specialist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forms Specialist this skillCommunity-Access/accessibility-agents422—~1.6kAutomated safety check: PassMIT
Web Interface Guidelines Reviewervercel-labs/openreview1.7k98 repos~308Automated safety check: PassNone
Accessibility Reviewmarkmead/hyperui12k1 repos~1.1kAutomated safety check: PassMIT
Web Animation DesignbaptisteArno/typebot.io11k2 repos~2.7kAutomated safety check: PassCustom licence
Accessibility Fixeribelick/ui-skills9.5k4 repos~1.2kAutomated safety check: PassMIT
Wcag Audit PatternsvmDeshpande/ai-agent-automation17811 repos~610Automated safety check: PassApache-2.0

Similar skills

  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 98 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Accessibility Review

    markmead/hyperui

    Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.

    12k GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Web Animation Design

    baptisteArno/typebot.io

    Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.

    11k GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed
  • Accessibility Fixer

    ibelick/ui-skills

    Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.

    9.5k GitHub starsUsed in 4 repos~1.2k tokens
    Frontend & DesignAuto-check passed
  • Wcag Audit Patterns

    vmDeshpande/ai-agent-automation

    Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.

    178 GitHub starsUsed in 11 repos~610 tokens
    Frontend & DesignAuto-check passed
  • Baseline UI

    ibelick/ui-skills

    Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.

    9.5k GitHub starsUsed in 8 repos~855 tokens
    Frontend & DesignAuto-check passed

More from Community-Access/accessibility-agents

All 108 skills in this repo
  • A11y Core

    Community-Access/accessibility-agents

    Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules.

    422 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Kb Web Scanning

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    422 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Accessibility Lead

    Community-Access/accessibility-agents

    Web UI accessibility lead. An agent skill from Community-Access/accessibility-agents.

    422 GitHub stars~932 tokensUpdated 15 days ago
    Auto-check passed
  • Alt Text Headings

    Community-Access/accessibility-agents

    Alt text, SVGs, figures, charts, heading order, page titles and landmarks.

    422 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed
  • Aria Specialist

    Community-Access/accessibility-agents

    ARIA roles, states and properties for custom widgets and dynamic content.

    422 GitHub stars~1.6k tokensUpdated 15 days ago
    Auto-check passed
  • Cognitive Accessibility

    Community-Access/accessibility-agents

    Plain language, WCAG 2.2 cognitive criteria, COGA guidance and auth UX.

    422 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed

Questions about Forms Specialist

What does Forms Specialist do?

Labels, validation, error handling, multi-step wizards and autocomplete. Forms Specialist is an agent skill from Community-Access/accessibility-agents. Labels, validation, error handling, multi-step wizards and autocomplete.

When should I use Forms Specialist?

Forms Specialist fits situations like: tasks that involve Accessibility.

How do I install Forms Specialist in Claude Code?

Run `npx skills add Community-Access/accessibility-agents --skill forms-specialist -a claude-code`. Or copy the skill folder (skills/forms-specialist in Community-Access/accessibility-agents) into .claude/skills/forms-specialist in your project. Claude Code loads it when a task matches its description.

How do I install Forms Specialist in Codex?

Run `npx skills add Community-Access/accessibility-agents --skill forms-specialist -a codex`. Or copy the skill folder (skills/forms-specialist in Community-Access/accessibility-agents) into .agents/skills/forms-specialist in your project. Codex loads it when a task matches its description.

Can I use Forms Specialist in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Community-Access/accessibility-agents --skill forms-specialist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forms-specialist, .gemini/skills/forms-specialist, .github/skills/forms-specialist and .opencode/skills/forms-specialist in your project.

What does Forms Specialist need to run?

SKILL.md names no scripts, command-line tools or credentials: Forms Specialist is instructions for the agent only.

Does Forms Specialist access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Forms Specialist safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Forms Specialist use?

Forms Specialist is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Forms Specialist use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.8k tokens, read only when the agent opens those files.

What are the alternatives to Forms Specialist?

Skills that share tags, products or a category with Forms Specialist: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forms Specialist?

Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 422 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on September 23, 2026.

Source: Community-Access/accessibility-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.