SkillAgentSearch skills...

multi-step-form-design

Designing forms with multiple steps, progress indicators, conditional logic, and save-and-resume mechanics. The discipline of breaking complex data collection into stages that respect cognitive load while maintaining completion intent.

Install / Use

npx skills add rampstackco/claude-skills --skill multi-step-form-design

Installs into whichever agent you are using.

About this skill
šŸ“„

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Our assessment of multi-step-form-design

multi-step-form-design scores 86/100 on our quality scale, 2460th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 21 KB long, well organised into 16 sections and no code examples: a thorough specification that gives an agent plenty to work with.

It has 902 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so multi-step-form-design is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

multi-step-form-design compared with similar skills

All 4 of these similar skills score higher than multi-step-form-design; compare them before choosing.

SkillScoreStarsUpdatedFormat
multi-step-form-design (this skill)by rampstackco869022mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install multi-step-form-design?
Run npx skills add rampstackco/claude-skills --skill multi-step-form-design. The install tabs above show the steps for each supported agent.
Which AI agents does multi-step-form-design work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is multi-step-form-design safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is multi-step-form-design still maintained?
The repository was last updated about 2 months ago, so multi-step-form-design is actively maintained.

name: multi-step-form-design description: "Designing forms with multiple steps, progress indicators, conditional logic, and save-and-resume mechanics. The discipline of breaking complex data collection into stages that respect cognitive load while maintaining completion intent. Honest about kitchen-sink-single-page (overwhelms before the user starts), progress-theater (steps without genuine staging), and genuinely-staged (each step earns its own page) patterns. Triggers on multi-step form, multi-page form, form wizard, signup wizard, lead form, application form, intake form, configurator, onboarding form. Also triggers when a long form is converting poorly, when an audience is dropping off mid-form, or when a multi-step form is being scoped for the first time." category: growth-tooling catalog_summary: "Designing multi-step forms that respect cognitive load while maintaining completion intent. Distinguishes kitchen-sink-single-page (overwhelms) from progress-theater (steps without genuine staging) from genuinely-staged (each step earns its own page)" display_order: 4

Multi-Step Form Design

A senior growth practitioner's playbook for designing forms with multiple steps, progress indicators, conditional logic, and save-and-resume mechanics. The discipline of breaking complex data collection into stages that respect cognitive load while maintaining completion intent.

Most multi-step forms are either kitchen-sink-single-pages dressed up as steps or arbitrary chunking that adds friction without adding clarity. The form looks more sophisticated; the completion rate does not move; the audience is no better served than before.

The multi-step forms that work do something different. Each step represents a coherent unit of cognitive work the user can complete with confidence. Progress indicators reinforce momentum. Conditional logic responds to earlier answers and removes irrelevant fields. The form feels like a guided process, not an obstacle course.

The voice is the senior growth practitioner who has watched multi-step forms convert at twice the single-page rate and watched them collapse to half. Practical, opinionated about when steps add value and when they add friction, willing to call out arbitrary chunking that does not earn its complexity.

When to use this skill: scoping a multi-step form for the first time, auditing a long single-page form that converts poorly, deciding when to break a form into steps and when to keep it on one page, or designing the conditional logic that makes the form feel adaptive.


What this skill covers

This skill spans multi-step form design across acquisition, onboarding, and intake contexts. The growth-tooling distinctions:

  • lead-magnet-design covers lead-magnet methodology; forms are one delivery surface for lead magnets but this skill is about the form itself.
  • landing-page-copy is the page wrapping the form. This skill is the form itself.
  • accessibility-audit covers accessibility deeply; forms have specific accessibility requirements; this skill references but does not replace accessibility-audit.
  • pm-spec-writing is the spec for engineers building the form. This skill is about WHAT to build; pm-spec-writing is about communicating it.
  • multi-step-form-design (this skill) is the form's structure, step architecture, progression, and validation.

The audience: growth marketers, product marketers, marketing teams designing acquisition forms, in-house teams designing onboarding flows, agencies running form-based growth tooling for clients.

Out of scope: form-builder platform configurations (those stay implementation-side); deep accessibility audits (covered by accessibility-audit); landing-page copy that wraps the form (covered by landing-page-copy).


The multi-step decision: when to break into steps vs keep single-page

Before designing the steps, decide whether the form should be multi-step at all.

Multi-step earns the build when:

  • The form has more than 8-10 fields. Single-page forms beyond this point overwhelm the audience visually.
  • The fields naturally group into logical categories. Personal info, then situation, then preferences. Steps that reflect real groupings respect cognitive load.
  • The audience benefits from progressive commitment. Each step builds investment; the user is more likely to complete after they have engaged with step 2 than they would have been if they had seen step 5's complexity upfront.
  • Different paths through the form make sense based on early answers. Conditional logic that adapts the form to the user is hard to do on a single page.

Multi-step does NOT earn the build when:

  • The form has 4-6 fields. A single-page form is faster to complete and faster to maintain.
  • The fields do not group naturally. Arbitrary chunking is friction.
  • The audience expects speed. Quick contact forms, simple lead-capture forms, and high-intent CTAs often convert better as single-page.
  • The team cannot maintain the multi-step complexity. Multi-step forms have more failure modes; the maintenance overhead is real.

The decision is not "should the form be multi-step"; it is "is multi-step the right structure for this specific data collection and audience."

Detail in references/multi-step-decision-criteria.md.


Kitchen-sink-single-page vs progress-theater vs genuinely-staged

The keystone framing.

Kitchen-sink-single-page. 30 fields on one page. Overwhelms before the user even starts. Drop-off near 100 percent on anything beyond a contact form. The audience scrolls, sees the length, and leaves. Cost: the form's data collection scope is correct; the structure is wrong; nobody completes it.

Progress-theater. The form is broken into 5 steps but the steps are arbitrary. "Step 1: name. Step 2: email. Step 3: phone. Step 4: company. Step 5: role." The progress bar exists; the staging logic does not. Cost: the form feels broken; users reach step 3 wondering why they did not just fill a single page; the completion rate may be slightly better than kitchen-sink but the audience perceives the format as gimmicky.

Genuinely-staged. Each step represents a coherent unit of cognitive work. The user finishes a step and feels they accomplished something. Steps progress from low-friction to higher-commitment as intent compounds. Cost: the design effort upfront is significant; the maintenance is real; the conversion rate often outperforms both alternatives meaningfully.

The litmus test. Ask a user who completed step 2 what they just did. Can they describe the unit of work as something coherent ("I gave you the basics about my company") or is the answer atomized ("I typed my company name in a field")? Coherent answers signal genuinely-staged; atomized answers signal progress-theater.


Step architecture: what belongs on each step

The structure that makes steps coherent.

The principle. Each step should represent a coherent unit of work from the user's perspective.

Common step patterns.

  • Identity step. Who the user is. Name, email, basic role. Low-friction; opens the form.
  • Context step. What the user's situation is. Company size, industry, current setup. Medium-friction; user shares context.
  • Need step. What the user is trying to accomplish. Goals, challenges, priorities. Higher-friction; user articulates intent.
  • Detail step. Specifics needed to act on the user's request. Budget, timeline, specific requirements. Highest-friction; saved for last.
  • Confirmation step. Review and submit. Summarizes what the user provided.

Step sequencing principle. Low-friction first; commitment compounds; high-friction at the end after the user has invested.

Step coherence test. Can each step be described in one sentence as a unit of work? "Step 2: tell us about your company's situation" beats "Step 2: company name, size, industry, and revenue range."

Detail in references/step-architecture-patterns.md.


Progress indicator design

When to show progress, what to show, how it builds momentum.

The principle. Progress indicators reinforce momentum and reduce uncertainty about how much is left.

Progress indicator patterns.

  • Step counter. "Step 2 of 4." Simple, common, effective for short forms (3-6 steps).
  • Progress bar. Visual fill showing percentage complete. Effective for forms with variable-length steps where step count alone is misleading.
  • Step list. Named steps shown with the current one highlighted. Useful when the user benefits from seeing what comes next.
  • No indicator. Sometimes appropriate for very short forms (2-3 steps) where the indicator overhead exceeds its value.

Progress indicator failures.

  • Indicator that shifts mid-form. "Step 4 of 5" becomes "Step 4 of 7" because conditional logic added steps. The user feels misled.
  • Indicator that hides remaining work. Showing "almost done" when 5 fields remain on the next step.
  • Indicator that is decorative without being honest. Progress that looks fast but the next step is the longest one.

Progress indicator discipline. The indicator must reflect the actual remaining work, not flatter the user.

Detail in references/progress-indicator-patterns.md.


Conditional logic

Branching that responds to earlier answers.

The principle. Show only fields that are relevant to the user's situation. Skip fields that do not apply.

Conditional logic patterns.

  • Show or hide fields based on previous answers. "If user selected 'enterprise,' show enterprise-specific fields."
  • Skip entire steps. "If user does not have a current CRM, skip the 'CRM details' step."
  • Adapt the language. "If user is in healthcare, use healthcare-specific terminology in subsequent fields."
  • Adapt the destination. "If user selected 'integration question,' route to the integration team after submission."

Conditional logic strengths.

  • Removes irrelevant friction.
  • Makes the form feel adaptive and intelligent.
  • Reduces drop-off because users do not abandon over fields that did not apply.

Conditional logic risks.

  • Maintenance complexity grows quickly.
  • Testing becomes harder (more paths through the form).
  • Progress indicators must adapt or honestly disclose the variability.

The simplicity preference. Add conditional logic only when it produces real value. Conditional logic for decoration adds maintenance without lift.

Detail in references/conditional-logic-patterns.md.


Save-and-resume mechanics

When to offer save-and-resume, how to communicate trust.

The principle. Save-and-resume reduces drop-off for forms that take more than 5 minutes to complete or that require information the user may not have at hand.

When save-and-resume helps.

  • Forms that require document uploads or specific information (W-2, financial details, technical configurations).
  • Forms that are part of multi-touchpoint workflows (loan applications, enrollment forms).
  • Forms where the user benefits from coming back to verify or update.

When save-and-resume does not help.

  • Quick lead-capture forms (under 60 seconds to complete).
  • Single-session forms where save-and-resume adds complexity without lift.

Save-and-resume mechanics.

  • Email-link recovery. "Save your progress; we will email you a link to continue." The most common pattern.
  • Account-based persistence. Forms that require account creation persist by default.
  • Anonymous-session save. Browser-based save without identification. Lowest friction but limited to the same browser/device.

Trust communication. Users hesitate to save partial sensitive information. The form should communicate clearly: what is saved, how long it persists, who can access it

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars902
CategoryDevelopment
Updated2mo ago
Forks124

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
multi-step-form-design — Universal Skill: Install & Safety Check | SkillAgent