ams-forms-pro
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
03 SKILL.md 正文
Forms Pro
A practical guide to web forms that convert and don't frustrate: UX patterns, validation timing, accessibility, multi-step flows, and file uploads — the details separating forms users complete from forms they abandon.
Overview
Forms are where business happens (signup, checkout, application) and where UX most often fails. The principles: minimize friction (fewer fields, smart defaults, autofill), validate helpfully (right time, clear messages, preserve input), and never lose user data (drafts, recovery). Technical implementation (React Hook Form, Zod — see those skills) serves these goals.
When to use
- Signup, checkout, application, settings, and contact forms.
- Multi-step wizards and conditional flows.
- File uploads with progress.
- Form UX audits and conversion optimization.
Core concepts
- Friction budget. Every field costs conversion. Cut ruthlessly: is this needed now, or can it be collected later / inferred / defaulted?
- Validation timing. Validate on blur/touch first, then live as the user fixes. Never error on pristine fields; never wait until submit for obvious mistakes (but always validate on submit too).
- Error UX. Inline errors next to fields, linked via
aria-describedby; error summary at top with anchor links on submit failure; focus moves to first error. Preserve all input on failed submit. - Input design. Right input for the data:
type="email|tel|number",inputmode,autocompleteattributes (huge for mobile), date pickers for dates (not free text), masks that help (not hinder). - Multi-step. One topic per step; progress indicator; back preserves everything; validate per step before advancing; review step before final submit; save drafts.
- File uploads. Drag-and-drop + browse; accept filters; size/type validation client-side (and server-side!); progress bars; resumable/chunked for large files; previews.
- Autosave. Draft persistence (localStorage or server) for long forms — losing 20 minutes of input is unforgivable.
Practical workflow
1. Design the fields.
- List every field; justify each ("why now?"). Remove half.
- Order: easiest first, sensitive (payment, SSN-equivalents) last.
- Group related fields with
<fieldset>/<legend>.
2. Markup (accessible by default).
<div>
<label for="email">Email address</label>
<input id="email" name="email" type="email" autocomplete="email"
required aria-describedby="email-hint email-error" />
<p id="email-hint">We'll send your receipt here.</p>
<p id="email-error" role="alert">Enter a valid email address.</p>
</div>
3. Validation.
- Schema (Zod/Yup) shared client/server.
mode: 'onTouched'(RHF) — validate after blur, revalidate live.- Server revalidates everything (client validation is UX, not security).
4. Multi-step state.
// single form state at wizard root; per-step validation via trigger(fields)
// persist draft: useEffect debounce → localStorage; restore on mount
5. Submit.
- Disable during submission; prevent double-submit.
- Success: clear draft, show confirmation (don't just redirect silently).
- Failure: preserve input, show errors, focus first error, log for debugging.
6. Uploads.
// chunked upload sketch: slice file, POST chunks with index, server assembles
// show per-file progress; validate type/size before uploading a byte
Common pitfalls
- Too many fields. The #1 form killer. Audit every field's necessity.
- Errors on pristine fields. Validating before the user interacts = hostile. onTouched/onBlur first.
- Wiping input on error. Failed submit clearing the form. Preserve everything, always.
- Placeholder as label. Disappears on type, poor contrast, not a real label. Real
<label>elements. - No autocomplete. Missing
autocompleteattributes = mobile users typing everything manually. Add them; it's free conversion. - Client-only validation. Bypassable in seconds. Server validates independently.
- No draft saving. Long forms without autosave. Persist drafts; users get interrupted.
- File upload failures. No size limits communicated, no progress, no resume — large uploads fail silently. Validate early, show progress, chunk large files.
- Inaccessible errors. Errors shown only in red text (no text = color-only), not linked to fields, not announced. Text +
aria-describedby+role="alert". - Submit button ambiguity. "Submit" vs "Create account" vs "Pay $49" — the button should say what happens. Include the consequence.
04 同仓库更多 Skills
web-scrape
Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.
design-taste-frontend
tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
requesting-code-review
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).