What is the building forms skill?
The building forms skill is in ancoleman/ai-design-components. It guides an AI coding agent through choosing the input for each data type, validating on blur with progressive enhancement, writing clear error messages and meeting WCAG 2.1 AA. It offers React with React Hook Form and Zod, and Python with Pydantic and FastAPI.
It is the building-forms skill in ancoleman/ai-design-components, a library of 76 skills across 10 domains according to its README. The description covers contact forms, registration flows, checkout, surveys and settings pages.
The skill describes 50 plus input types, validation strategies, WCAG 2.1 accessibility patterns, multi-step wizards and decision trees from data type to component. Detailed guides sit in a references folder, with examples and JSON assets.
What changes in your agent's output
- Input choice follows a rule: short text gets a text input, long text a textarea, two to seven options a radio group, and more than seven a select, with autocomplete past fifteen.
- Validation defaults to on blur: no errors while the field is untouched or being typed in, then on change after the first error, with success shown right away.
- Error messages state what is wrong, why it matters and how to fix it, in a helpful tone.
- Fields get associated labels, aria-describedby for errors, aria-invalid on failure and focus moved to the first error on submit.
Stacks it covers
React is the primary stack, using React Hook Form for state, Zod for schemas and Radix UI or React Aria for primitives. Python uses Pydantic, FastAPI and WTForms. Rust and Go sections are marked as planned, not written.
Who the building forms skill is for
Best for
- Developers adding sign-up, checkout, survey or settings forms who want consistent validation and accessibility.
- Multi-step wizards, conditional fields and repeating sections, which the skill lists as complex patterns.
- Pairing with the form design skill for layout and flow, or the WCAG accessibility audit skill for review.
Not for
- Rust or Go projects, where the skill says implementations will be added later.
- Teams wanting a visual form builder. This skill gives guidance and code examples, not a drag and drop tool.
Use it with UiChemy
Use it to specify the fields, validation and error states of a contact or checkout form before you design the page. Then build the page in WordPress with UiChemy. Click Get Started on uichemy.com. For tokens used by inputs, see the design tokens skill.
How to install Building Forms Skill: Validation and Accessible Inputs
git clone https://github.com/ancoleman/ai-design-components.gitThe repository's last push on GitHub is Dec 11, 2025, so check that the React and Python library versions it names still match your project.Clone the repository
Run
git clone https://github.com/ancoleman/ai-design-components.gitand change into the folder.Use the installer or copy the skill
The README's recommended route is
./install.sh, an interactive menu for skills, skillchain and plugins. You can also copy skills/building-forms into your agent's skills folder.Or use plugin commands
The README also shows Claude plugin marketplace commands for the repository's 19 plugin groups.
Ask for a form
Ask for a registration form with validation or an accessible multi-step checkout. The skill triggers on form and validation requests.
Check that it loaded
Ask for a login form in React. The agent should use React Hook Form with a Zod schema, on blur validation, visible labels and role alert error messages.
Key features
- Component selection frameworkA golden rule of data type to input component to validation pattern, with a quick reference by data type.
- Five validation modesOn submit, on blur, on change, debounced and progressive, with on blur plus progressive enhancement as the recommended default.
- Error message formulaSay what is wrong, why it matters and how to fix it, with bad and good examples and tone guidelines.
- WCAG 2.1 AA patternsVisible labels, required fields not shown by color alone, keyboard order, focus visibility and aria-live validation messages.
- Three component tiersBasic inputs, rich inputs such as combobox, file upload and rating, and complex patterns such as wizards and field arrays.
- React stackReact Hook Form with Zod and a zodResolver, using on blur mode, plus Radix UI or React Aria primitives.
- Python stackPydantic models with FastAPI for automatic 422 validation errors, and WTForms for Flask or Django.
- Design token integrationInputs, borders, spacing, focus rings and error states are meant to be themed through the companion design-tokens skill.
- Worked examplesThe folder includes basic, inline validation, conditional, multi-step wizard and settings form examples, plus Python examples.
- Reusable assetsJSON schemas for contact and registration forms, validation rules for email and phone formats, and error messages in three languages.
Frequently asked questions
What is the building forms skill?
It is a skill in ancoleman/ai-design-components that guides an AI coding agent in building form interfaces: choosing inputs, timing validation, writing error messages, meeting WCAG 2.1 AA and handling wizards, with React and Python examples.
How do I install the building forms skill?
Clone the repository and run its install script, or copy skills/building-forms into your agent's skills directory. The README also documents Claude plugin commands, and the skill folder keeps its references, examples and assets together.
When should validation run?
The skill recommends on blur with progressive enhancement. Show nothing while the field is untouched or being typed in, validate when focus leaves, then switch that field to on change after the first error and show success immediately.
Which libraries does it recommend?
For React it names React Hook Form, Zod and Radix UI or React Aria. For Python it names Pydantic, FastAPI and WTForms. Rust and Go libraries are listed only as planned work, not implemented.
Does it cover accessibility?
Yes. It covers labels, keyboard navigation, error association with aria-describedby, aria-live announcements and required field indicators. A longer accessibility-forms reference holds the WCAG 2.1 checklist, and the accessibility testing skill can verify the result.
Can it help with multi-step forms?
Yes. It lists linear and branching wizards, progress indicators, save and resume, and review before submit. A multi-step wizard example is included in the examples folder, along with conditional field and settings examples.
How is it different from the form design skill?
The form design skill centers on fields, errors and flow. This one adds library choices, a validation timing model and code examples in React and Python, so it suits implementation work.
What license does it use?
GitHub shows ancoleman/ai-design-components under the MIT license. Read the repository's license file for the exact terms before you reuse or redistribute the skill, and keep its copyright notice with any copy you share.


