# Fill Multi Step Form

> Fills a multi-step form (stepper wizard) by routing labeled fields to values from `vars`, clicking "Next" between steps, and submitting at the end. Pairs with the `searchable-dropdown` and `date-picker-widget` skills for compound widgets.

- **Type:** Skill
- **Install:** `agentstack add skill-bettyguo-browser-skills-fill-multi-step-form`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bettyguo](https://agentstack.voostack.com/s/bettyguo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bettyguo](https://github.com/bettyguo)
- **Source:** https://github.com/bettyguo/browser-skills/tree/main/skills/fill-multi-step-form

## Install

```sh
agentstack add skill-bettyguo-browser-skills-fill-multi-step-form
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Fill Multi-Step Form

## When to invoke

The page has a form spread across multiple steps (Typeform, Calendly, hotel
checkout, multi-page job applications, etc.). The agent has the values to fill
in `vars` keyed by either field-`name`, field-`id`, or label text.

The matcher runs this skill when the DOM has a `` plus any
step-indicator marker. Without step-indicators, the simpler
single-step form pattern (`fill` primitive calls authored by the agent
directly) usually suffices.

## Recipe

1. wait_for_dom_ready timeout=5s
2. wait_for_selector selector="form, [role='form']" state=visible timeout=5s
3. fill selector="input[name='name'], input[id*='name' i][type='text']" value="$vars.name"
4. fill selector="input[type='email'], input[name*='email' i]" value="$vars.email"
5. click selector="button:has-text('Next'), button:has-text('Continue'), button[type='submit']" timeout=2s
6. wait extra=400ms

## Success criteria

- assert no_visible_element selector="[role='alert'][aria-invalid='true']"
- assert step_indicator_advanced

## Notes

The recipe above is the minimum-viable scaffolding. Real forms vary
widely; agents are expected to compose `fill` primitives directly when
the field set is fully known up front. This skill is most useful when:

- The field set is partially unknown until later steps render
- Validation errors must be detected and recovered (handled by the
  agent on `failed` return)

## When NOT to use

- Login forms — use `login-flow`.
- Forms inside a captcha-protected flow — `detect-captcha` first.

## Known failures

- **Hidden fields with same name as visible fields:** the selector
  picks the wrong one. Workaround: use an `id` selector instead.
- **Steps that conditionally show fields based on earlier answers:**
  v0.1 doesn't handle dynamic form structure. Agent must invoke the
  skill once per step.
- **Drag-and-drop fields, signature widgets:** out of scope.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bettyguo](https://github.com/bettyguo)
- **Source:** [bettyguo/browser-skills](https://github.com/bettyguo/browser-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bettyguo-browser-skills-fill-multi-step-form
- Seller: https://agentstack.voostack.com/s/bettyguo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.