browser-dropdown-selection

Select native and custom browser dropdown options using numbered DOM snapshots.

38|6|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/7757/Fan-Browser-Agent --skill browser-dropdown-selection-7757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: browser-dropdown-selection
Source: https://github.com/7757/Fan-Browser-Agent/tree/main/skills/browser/browser-dropdown-selection
Command: npx skills add https://github.com/7757/Fan-Browser-Agent --skill browser-dropdown-selection-7757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Selecting options in web dropdowns is error-prone for browser agents: native <select> elements behave differently from custom ARIA widgets, options may only render after opening a menu, and stale element references break after navigation. This Skill provides a deterministic procedure for choosing the right selection path and verifying the result. ## Core Features & Use Cases - Native and Custom Dropdown Handling: Uses fan.select for native selects and recognized custom widgets, with an open-observe-click fallback for complex ARIA listboxes and comboboxes. - Option Inspection and Uniqueness Checks: Lists available options via fan.dropdownOptions and enforces exact, unique matches with fan.requireUnique instead of guessing. - Dynamic Menu Recovery: Handles searchable comboboxes and virtualized long menus by observing fresh snapshots and scrolling containers until the target option renders. - Use Case: While filling a multi-step registration form, select "United States" from a country dropdown, type into other fields, and submit—all in one browser_run transaction using stable snapshot references. ## Quick Start Ask the agent to select a specific option from a dropdown on the current page, for example: select "California" from the state dropdown and confirm the form shows the chosen value.

Frequently Asked Questions about browser-dropdown-selection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I select a dropdown option in browser automation?▼

Use fan.select with a numbered reference from the current snapshot, passing the exact visible text or value of the option. For native select elements, select directly through the control without clicking it first or inventing numbers for its options.

How to handle custom dropdowns that are not native select elements?▼

Custom dropdowns built from buttons, divs, or listboxes may need an open-observe-click fallback. Click the trigger, call fan.observe to get fresh elements, filter for option-like roles with an exact label match, and click the resulting element object directly.

Why does my dropdown selection fail after page navigation?▼

Selection fails when fan.ref(N) references are reused after navigation or a fresh observation, since numbers belong to a specific snapshot generation. Always take a new snapshot and use its current numbers after any dynamic page change.

How do I select an option in a searchable combobox?▼

Open the combobox, observe the fresh input, type the filter text, observe the filtered options, require exactly one exact match, and click that element. Avoid pressing Enter because it may submit the surrounding form prematurely.

What should I do when a dropdown option is not visible in a long menu?▼

For long or virtualized menus, scroll the observed container with fan.scroll, observe again, and match the newly rendered option. An option cannot be addressed before it is actually rendered in the DOM.