Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ancoleman avatar

Building Forms

ancoleman/ai-design-components

  • 66 installs
  • 426 repo stars
  • Updated December 11, 2025
  • ancoleman/ai-design-components

Building-forms is a Claude Code skill that builds form components and data-collection interfaces with 50+ input types, validation strategies, and WCAG 2.1 accessibility patterns.

About

Building-forms is a Claude Code skill for building form components and data-collection interfaces such as contact forms, registration flows, checkout processes, and surveys. A developer uses it when collecting user input, implementing validation, or ensuring form accessibility. It provides component-selection decision trees, validation-timing guidance, WCAG 2.1 AA accessibility patterns, and multi-step wizard structures.

  • 50+ input types with data-type-to-component decision trees
  • Validation timing strategies (on-blur, on-change, debounced, progressive)
  • WCAG 2.1 AA accessibility patterns and multi-step wizards

Building Forms by the numbers

  • 66 all-time installs (skills.sh)
  • Ranked #1,170 of 2,245 Frontend Development skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

building-forms capabilities & compatibility

Capabilities
building forms · building tables · creating dashboards · building ai chat
Use cases
frontend · ui design · web design
From the docs

What building-forms says it does

Includes 50+ input types, validation strategies, accessibility patterns (WCAG 2.1), multi-step wizards, and UX best practices.
SKILL.md
The Golden Rule:** Data Type → Input Component → Validation Pattern
SKILL.md
npx skills add https://github.com/ancoleman/ai-design-components --skill building-forms

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs66
repo stars★ 426
Last updatedDecember 11, 2025
Repositoryancoleman/ai-design-components ↗

What it does

Build accessible forms with the right input types, validation timing, and multi-step wizard flows.

Who is it for?

Building accessible forms, checkout flows, and surveys with proper validation.

Skip if: Backend form-submission processing or database schema.

When should I use this skill?

Creating forms, collecting user input, or implementing validation and multi-step workflows.

What you get

Accessible, user-friendly forms with appropriate inputs, validation timing, and WCAG 2.1 AA compliance.

  • Input component selection
  • Validation strategy
  • Accessible form markup (WCAG 2.1 AA)

By the numbers

  • 50+ input types
  • 5 validation modes (On Submit, On Blur, On Change, Debounced, Progressive)

Files

SKILL.mdMarkdownGitHub ↗

Form Systems & Input Patterns

Build accessible, user-friendly forms with systematic component selection, validation strategies, and UX best practices.

Purpose

Forms are the primary mechanism for user data input in web applications. This skill provides systematic guidance for:

  • Selecting appropriate input types based on data requirements
  • Implementing validation strategies that enhance user experience
  • Ensuring WCAG 2.1 AA accessibility compliance
  • Creating complex patterns (multi-step wizards, conditional fields, dynamic forms)

When to Use This Skill

Triggers:

  • Building contact forms, login/registration flows, checkout processes
  • Implementing surveys, questionnaires, or settings pages
  • Adding validation to user inputs
  • Creating multi-step workflows or wizards
  • Ensuring form accessibility
  • Collecting structured data (addresses, credit cards, dates)

Common Requests:

  • "Create a registration form with validation"
  • "Build a multi-step checkout flow"
  • "Add inline validation to email input"
  • "Make this form accessible for screen readers"
  • "Implement a survey with conditional questions"

Universal Form Concepts

Component Selection Framework

The Golden Rule: Data Type → Input Component → Validation Pattern

Start by identifying the data type to collect, then select the appropriate component:

Quick Reference:

  • Short text (<100 chars) → Text input, Email input, Password input
  • Long text (>100 chars) → Textarea, Rich text editor, Code editor
  • Numeric → Number input, Currency input, Slider
  • Date/Time → Date picker, Time picker, Date range picker
  • Boolean → Checkbox, Toggle switch
  • Single choice → Radio group (2-7 options), Select dropdown (>7 options), Autocomplete (>15 options)
  • Multiple choice → Checkbox group, Multi-select, Tag input
  • File/Media → File upload, Image upload
  • Structured → Address input, Credit card input, Phone number input

For detailed decision tree: See references/decision-tree.md

Validation Timing Strategies

Recommended Default: On Blur with Progressive Enhancement

Field pristine (never touched): No validation
User typing: No errors shown
On blur (field loses focus): Validate and show errors
After first error: Switch to onChange for that field
On fix: Show success immediately

Validation Modes: 1. On Submit - Validate when form submitted (simple forms) 2. On Blur - Validate when field loses focus (RECOMMENDED for most forms) 3. On Change - Validate as user types (password strength, availability checks) 4. Debounced - Validate after user stops typing (API-based validation) 5. Progressive - Start with on-blur, switch to on-change after first error

For complete validation guide: See references/validation-concepts.md

Accessibility Requirements (WCAG 2.1 AA)

Critical Accessibility Patterns:

Labels and Instructions:

  • Every input must have an associated <label> or aria-label
  • Labels must be visible and descriptive
  • Required fields clearly indicated (not by color alone)
  • Never use placeholder text as label replacement
  • Provide help text for complex inputs

Keyboard Navigation:

  • Logical, sequential tab order
  • All inputs keyboard accessible
  • Custom components support arrow keys
  • Escape key dismisses modals/popovers
  • Focus visible (outline or custom indicator)

Error Handling:

  • Errors programmatically associated with inputs (aria-describedby)
  • Error messages clear and actionable
  • Errors announced by screen readers (aria-live)
  • Focus moves to first error on submit
  • Errors not conveyed by color alone

ARIA Attributes:

  • aria-required="true" for required fields
  • aria-invalid="true" when validation fails
  • aria-describedby linking to help/error text
  • role="group" for related inputs
  • aria-live="polite" for validation messages

For complete accessibility checklist: See references/accessibility-forms.md

UX Best Practices

Modern Form UX Principles (2024-2025):

1. Progressive Disclosure - Show only essential fields initially, reveal advanced options on demand 2. Smart Defaults - Pre-fill known information, suggest values based on context 3. Inline Validation with Positive Feedback - Show green checkmark on valid input, provide helpful error messages 4. Mobile-First - Large touch targets (44px minimum), appropriate keyboard types 5. Reduce Cognitive Load - Group related fields, use clear labels, provide examples 6. Error Prevention - Constraints prevent invalid input, autocomplete reduces typos 7. Autosave and Recovery - Save draft state automatically, warn before losing data

For detailed UX patterns: See references/ux-patterns.md

Error Message Best Practices

Good Error Message Formula: 1. What's wrong - "Email address is not valid" 2. Why it matters - "We need this to send your receipt" 3. How to fix - "Format: name@example.com"

Examples:

❌ Bad: "Invalid input" ✅ Good: "Email address must include @ symbol (e.g., name@example.com)"

❌ Bad: "Error" ✅ Good: "Password must be at least 8 characters long"

❌ Bad: "Field required" ✅ Good: "Please enter your email address so we can send order confirmation"

Tone Guidelines:

  • Conversational, not robotic
  • Helpful, not blaming
  • Specific, not generic
  • Actionable, not just descriptive

Language-Specific Implementations

This skill provides universal form concepts above, with language-specific implementations below.

JavaScript/React (PRIMARY)

Recommended Stack:

  • React Hook Form - Form state management (best performance, 8KB bundle)
  • Zod - TypeScript-first schema validation
  • Radix UI or React Aria - Accessible component primitives

Quick Start:

import { useForm } from 'react-hook-form';
import { zodResolver } from '@hookform/resolvers/zod';
import * as z from 'zod';

// Define validation schema
const schema = z.object({
  email: z.string().email('Invalid email address'),
  password: z.string().min(8, 'Password must be at least 8 characters'),
});

type FormData = z.infer<typeof schema>;

function LoginForm() {
  const { register, handleSubmit, formState: { errors } } = useForm<FormData>({
    resolver: zodResolver(schema),
    mode: 'onBlur', // Validate on blur (recommended)
  });

  const onSubmit = (data: FormData) => {
    console.log(data);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <label htmlFor="email">Email</label>
      <input id="email" {...register('email')} type="email" />
      {errors.email && <span role="alert">{errors.email.message}</span>}

      <label htmlFor="password">Password</label>
      <input id="password" {...register('password')} type="password" />
      {errors.password && <span role="alert">{errors.password.message}</span>}

      <button type="submit">Login</button>
    </form>
  );
}

Detailed JavaScript/React Documentation:

  • references/javascript/react-hook-form.md - Complete React Hook Form guide
  • references/javascript/zod-validation.md - Zod schema validation patterns
  • references/javascript/examples/ - Working code examples

Python (PRIMARY)

Recommended Stack:

  • Pydantic - Data validation and settings management (runtime validation, type-safe)
  • FastAPI - Modern async web framework with automatic validation
  • WTForms - Flask/Django form handling (when using traditional frameworks)

Quick Start (FastAPI + Pydantic):

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel, EmailStr, Field, validator

app = FastAPI()

# Define validation schema
class LoginForm(BaseModel):
    email: EmailStr  # Validates email format
    password: str = Field(..., min_length=8, description="Password must be at least 8 characters")

    @validator('password')
    def validate_password_strength(cls, v):
        if not any(char.isdigit() for char in v):
            raise ValueError('Password must contain at least one number')
        if not any(char.isupper() for char in v):
            raise ValueError('Password must contain at least one uppercase letter')
        return v

@app.post("/api/login")
async def login(form_data: LoginForm):
    # Pydantic automatically validates incoming data
    # If validation fails, returns 422 with error details
    return {"message": "Login successful", "email": form_data.email}

# Example error response (automatic):
# {
#   "detail": [
#     {
#       "loc": ["body", "email"],
#       "msg": "value is not a valid email address",
#       "type": "value_error.email"
#     }
#   ]
# }

Detailed Python Documentation:

  • references/python/pydantic-forms.md - Pydantic validation patterns
  • references/python/wtforms.md - WTForms for Flask/Django
  • references/python/examples/ - Working code examples

Rust (FUTURE)

Planned Libraries:

  • validator - Struct field validation
  • Leptos / Yew - Reactive web frameworks

Rust implementation will be added when needed.

Go (FUTURE)

Planned Libraries:

  • Templ - Type-safe HTML templating
  • html/template - Standard library templating

Go implementation will be added when needed.

Component Tiers

Tier 1: Basic Input Components

Text-Based:

  • Text field (single-line)
  • Textarea (multi-line)
  • Email input (with validation)
  • Password input (with visibility toggle)
  • Number input (with step controls)
  • Tel input (with formatting)
  • URL input (with protocol validation)
  • Search input (with clear button)

Selection:

  • Radio group (2-7 options)
  • Checkbox (boolean or multiple)
  • Toggle switch (clear on/off states)
  • Select dropdown (many options)
  • Multi-select (multiple selections)

Date & Time:

  • Date picker (calendar interface)
  • Time picker (hour/minute)
  • Date range picker (start and end)
  • DateTime picker (combined)

Tier 2: Rich Input Components

Advanced Selection:

  • Autocomplete/Combobox (type to filter)
  • Tag input (multiple tags)
  • Transfer list (move items between lists)
  • Listbox (keyboard-navigable)

Specialized:

  • Color picker (hex, RGB, HSL)
  • File uploader (single, multiple, drag-drop)
  • Image uploader (crop, resize, preview)
  • Slider/Range (single or range)
  • Rating input (stars, numeric, emoji)
  • Rich text editor (formatting, media)
  • Code editor (syntax highlighting)
  • Markdown editor (preview, toolbar)

Structured Data:

  • Address input (multi-field)
  • Credit card input (formatted)
  • Phone number (international)
  • Currency input (symbol, decimal)

Tier 3: Complex Form Patterns

Multi-Step Forms:

  • Linear wizard (step 1 → 2 → 3)
  • Branching wizard (conditional steps)
  • Progress indicators
  • Save and resume (draft state)
  • Review and submit page

Dynamic Forms:

  • Conditional fields (show/hide)
  • Repeating sections (add/remove)
  • Field arrays (dynamic list)
  • Nested forms (complex objects)

Advanced Patterns:

  • Inline editing (click to edit)
  • Bulk editing (multiple records)
  • Autosave (periodic or on change)
  • Optimistic updates
  • Undo/redo functionality

Integration with Design Tokens

All form components use the design-tokens skill for visual styling, enabling theme switching (light/dark/high-contrast/custom brands).

Key Token Categories:

  • Color - Input backgrounds, borders, text, error/success states
  • Spacing - Padding, gaps between fields, label margins
  • Typography - Font sizes, weights for inputs, labels, errors
  • Borders - Border width, radius, focus ring
  • Shadows - Focus indicators, elevation

See: skills/design-tokens/ for complete theming documentation.

Common Use Cases

Contact Form

// Basic contact form with validation
// See: references/javascript/examples/basic-form.tsx

Registration Flow

// Multi-step registration with password strength
// See: references/javascript/examples/multi-step-wizard.tsx

Inline Validation

// Real-time validation with debouncing
// See: references/javascript/examples/inline-validation.tsx

Survey with Conditional Logic

// Dynamic form with conditional fields
// See: references/javascript/examples/conditional-form.tsx

Settings Page

// Mixed input types with autosave
// See: references/javascript/examples/settings-form.tsx

Quick Decision Guide

Question: What input should I use? → See references/decision-tree.md for complete decision tree

Question: When should I validate? → Use on-blur with progressive enhancement (on-change after first error) → See references/validation-concepts.md for all strategies

Question: How do I make my form accessible? → Use semantic HTML, label all inputs, support keyboard navigation → See references/accessibility-forms.md for WCAG 2.1 checklist

Question: How do I handle complex validation? → Use schema validation (Zod for TypeScript, Yup for JavaScript) → See references/javascript/zod-validation.md for patterns

Question: How do I build a multi-step form? → Use state management with progress tracking → See references/javascript/examples/multi-step-wizard.tsx

Best Practices Summary

1. Start with semantic HTML - Use native <input>, <select>, <textarea> when possible 2. Label everything - Every input needs a visible, descriptive label 3. Validate on blur - Best UX balance for most forms 4. Provide helpful errors - Explain what's wrong and how to fix it 5. Support keyboard navigation - Tab order, arrow keys, escape to dismiss 6. Mobile-first - Large touch targets, appropriate keyboards 7. Progressive disclosure - Don't overwhelm with all fields at once 8. Autosave when possible - Prevent data loss 9. Test with screen readers - Ensure ARIA attributes work correctly 10. Use design tokens - Consistent styling, theme support

Additional Resources

  • references/decision-tree.md - Complete component selection framework
  • references/validation-concepts.md - All validation strategies and patterns
  • references/accessibility-forms.md - WCAG 2.1 AA compliance checklist
  • references/ux-patterns.md - Modern form UX best practices
  • references/javascript/ - JavaScript/React implementation guides

Related skills

vercel-labsVercel React Best PracticesAutomatically apply Vercel’s official React and Next.js performance rules during code generation and review.587k29.6kvercel-labsVercel Composition PatternsGenerate and refactor React components that stay maintainable as complexity grows without boolean prop explosion.267k29.6kshadcnShadcnAdd, compose, search, fix, and style production-grade React components directly from source without leaving their editor.257k120kxixu-meDevelop UserscriptsCorrectly write, debug, and package userscripts for Tampermonkey and ScriptCat with proper metadata, GM APIs, and runtime decisions.224k72leonxlnxMinimalist UiGenerate clean, editorial-style web interfaces with warm monochrome palettes, typographic hierarchy, bento grids and flat components that feel premium and utilita212k69.4kleonxlnxImage To CodeConvert high-fidelity design images into production-ready, visually accurate frontend code that avoids generic AI design pitfalls.177k69.4k

FAQ

What validation timing does it recommend?

On-blur with progressive enhancement: validate when a field loses focus, then switch to on-change for that field after its first error.

How does it pick input components?

By the golden rule Data Type -> Input Component -> Validation Pattern, using a component-selection decision tree.

Frontend Developmentfrontend
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.