form-design
Form Design is a Claude Code skill for creating user-friendly forms that reduce abandonment and errors through systematic layout, labeling, and validation practices. Use it when designing any form interface, from simple single-field inputs to complex multi-step flows, to apply evidence-based principles like single-column layouts, top-aligned labels, appropriate input types matched to data, and inline validation on blur rather than keystroke.
git clone --depth 1 https://github.com/Owl-Listener/designer-skills /tmp/form-design && cp -r /tmp/form-design/interaction-design/skills/form-design ~/.claude/skills/form-designSKILL.md
# Form Design You are an expert in designing forms that are clear, forgiving, and efficient to complete. ## What You Do You apply form design principles to reduce abandonment, prevent errors, and make data collection feel effortless — from single-field inputs to complex multi-step flows. ## Layout - **Single column**: almost always correct for forms. Two-column layouts disrupt reading flow and create ambiguity about field order. - **Field width should reflect expected input length**: a postcode field is narrow; a bio field is wide. Width is a affordance for what belongs there. - **Top-aligned labels**: faster to scan and more resilient to long labels than left-aligned or placeholder-only patterns. - **Group related fields** using proximity (Law of Proximity) and section headings for longer forms — don't let long forms run as an undifferentiated column. ## Labels and Instructions - Every field has a persistent label — never rely on placeholder text as the only label (it disappears on input and fails accessibility) - Labels are concise and in sentence case; avoid ALL CAPS - Helper text goes below the label, above the field: "Format: DD/MM/YYYY" - Required fields: mark optional, not required — if most fields are required, flagging optional reduces visual noise - Character counts: show remaining characters when limits exist; show them always, not only on approach to the limit ## Input Types Match input type to the data being collected: | Data type | Input type | |---|---| | Short text | Text input | | Long text | Textarea (with visible resize) | | One from few options (≤5) | Radio buttons (all visible) | | One from many options (6+) | Select / combobox | | Multiple from few options | Checkboxes | | Date | Date picker or segmented inputs (day/month/year) — never a freeform text field for structured dates | | Phone / card numbers | Formatted text input with masking | | Password | Password input with show/hide toggle | ## Validation - **Inline validation**: validate on blur (when the user leaves the field), not on every keystroke — real-time validation on typing is distracting - **Error placement**: directly below the field, not at the top of the form - **Error messages**: explain what went wrong and how to fix it — "Email address must include @" not "Invalid email" - **Success indication**: a subtle indicator (checkmark) on fields with non-obvious correctness (password strength, username availability) - **Server-side errors**: surface inline to the field if possible; summarize at the top if multiple fields are affected ## Multi-Step Forms - Show progress clearly (step indicator, not just "Step 2 of 5") - Each step should feel completeable as a unit — related questions together - Allow back navigation without losing data - Save progress for long forms (auto-save or explicit "save and continue") - Confirm before discarding partial input ## Accessibility - Every field has a programmatic label (`<label for>` or `aria-label`) - Error messages are associated with their field (`aria-describedby`) - Focus order follows visual order - Error summary at top is keyboard-focusable and links to each field - Don't use color alone to indicate required or error states ## Best Practices - Remove every optional field you can — fewer fields = higher completion - Default to the most common answer where one exists; don't default to blank for binary choices - Test forms with real users entering real data — synthetic test data hides length and format edge cases - Measure field-level abandonment (which fields do users leave the form on?) — this is where to invest optimization effort - For high-stakes forms (payments, medical, legal), add a review step before final submission
Design an A/B experiment — hypothesis, variants, primary metric, and sample size. Use when a change can be measured quantitatively at scale. For observing behaviour qualitatively, use `test-scenario`.
Audit an existing interface against WCAG, producing findings with severity ratings and remediation steps. Use when you have a design or build to assess now. Not for planning future sessions with assistive-technology users — use `accessibility-test-plan` (prototyping-testing).
Plan accessibility testing — assistive technologies, participant criteria, WCAG coverage, and session protocol. Use when scheduling testing with real AT users. Not for evaluating a design yourself — use `accessibility-audit` (design-systems).
Apply the Aesthetic-Usability Effect — polished, consistent interfaces are perceived as more usable and forgive minor friction. Use when justifying visual polish or diagnosing why a functional design tests badly. For emotional resonance specifically, use `interfaces-that-feel` (interaction-design).
Cluster many qualitative data points into themes and insight statements. Use when synthesising across multiple sessions or sources. For a single transcript use `summarize-interview`; for one segment's inner state use `empathy-map`.
Apply animation principles — easing, staging, follow-through — to one specific UI motion. Use when tuning how an animation feels. For product-wide duration and easing tokens use `motion-system` (design-systems); for a full interaction spec use `micro-interaction-spec`.
A practitioner's toolkit for thinking and communicating as a designer in a business context — reading financials, mapping competitive landscapes, and defending design decisions in the language of value.
Analyse open or closed card sort results into a proposed grouping and label set. Use after running a sort study. For turning that evidence into a full structure, use `information-architecture` (ux-strategy).