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

Form Design

  • 637 installs
  • 2k repo stars
  • Updated June 14, 2026
  • owl-listener/designer-skills

form-design is an owl-listener designer-skills agent skill that applies form UX principles so developers build clear, low-friction inputs and multi-step flows that reduce abandonment and input errors.

About

form-design is an owl-listener designer-skills module that instructs agents to design forms minimizing friction, preventing errors, and guiding users to successful completion. The skill prescribes single-column layouts as the default, field widths matched to expected input length, and patterns that make data collection feel efficient from single-field inputs through complex multi-step flows. Developers invoke form-design when implementing checkout, onboarding, settings, or admin forms in web or mobile apps and want opinionated UX guardrails instead of ad hoc field stacking. It emphasizes readability, forgiving validation, and layout affordances rather than visual branding or color systems.

  • form-design

Form Design by the numbers

  • 637 all-time installs (skills.sh)
  • +65 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #604 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/owl-listener/designer-skills --skill form-design

Add your badge

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

Listed on Skillselion
Installs637
repo stars2k
Last updatedJune 14, 2026
Repositoryowl-listener/designer-skills

How do you design low-friction multi-step forms?

Use form-design for development tasks

Who is it for?

Frontend developers and designers implementing registration, checkout, or settings forms who want structured UX rules during build.

Skip if: Backend API schema design, full visual branding systems, or teams needing only color-token documentation without form behavior guidance.

When should I use this skill?

A developer asks to design or refactor forms, reduce form abandonment, or improve multi-step input UX.

What you get

Form layout specs, field-order guidance, validation UX patterns, and multi-step flow recommendations ready for frontend implementation.

  • form layout guidance
  • validation UX patterns
  • multi-step flow recommendations

Files

SKILL.mdMarkdownGitHub ↗

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 typeInput type
Short textText input
Long textTextarea (with visible resize)
One from few options (≤5)Radio buttons (all visible)
One from many options (6+)Select / combobox
Multiple from few optionsCheckboxes
DateDate picker or segmented inputs (day/month/year) — never a freeform text field for structured dates
Phone / card numbersFormatted text input with masking
PasswordPassword 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

Related skills

How it compares

Use form-design for field-level UX and layout; pair with broader design-system skills when typography, color, or component libraries need full visual direction.

FAQ

What layout does form-design recommend by default?

form-design recommends single-column layouts for almost all forms, arguing two-column layouts disrupt reading flow and create ambiguity about field order during completion.

How does form-design use field width?

form-design instructs matching field width to expected input length—narrow for postcodes, wide for bios—so width acts as an affordance for the data being collected.

Backend & APIsbackendintegrations

This week in AI coding

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

unsubscribe anytime.