browser-file-upload

Attaches local files to web form file inputs using browser automation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Uploading a local file through a web form often fails because the real file input is hidden behind a styled button or drop-zone, or because the local path is wrong. This Skill guides the agent to locate the actual <input type="file">, validate the file path, and confirm the attachment succeeded. ## Core Features & Use Cases - Hidden input discovery: Uses browser_find_elements(selector="input[type=file]"), clicking, and scrolling to reveal file inputs that do not appear in the normal page observation. - Path and type validation: Ensures the local path is absolute, the file exists, and the file type matches the input's accept attribute before uploading. - Upload and verification: Calls browser_upload with a single path or multiple files, then re-observes the page to confirm a filename, thumbnail, or count indicator appeared. - Use Case: When filling a visa application form that requires attaching a passport scan, locate the hidden file input behind the "Add document" button, upload C:/docs/passport.pdf, and verify the attachment indicator appears. ## Quick Start Upload the local file report.pdf to the file input on this web form and confirm the attachment appears.

Frequently Asked Questions about browser-file-upload

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

FAQPage Schema
How do I upload a file to a web form with browser automation?▼

Find the file input's index with browser_observe or browser_find_elements(selector="input[type=file]"), then call browser_upload with that index and an absolute local path. Re-observe the page afterward to confirm the filename or attachment indicator appeared.

How to find a hidden file input behind an upload button?▼

Query the DOM directly with browser_find_elements(selector="input[type=file]") to locate hidden inputs, or click the visible upload button and re-observe the page. Scrolling the form area into view can also reveal the input in the observation.

Can I upload multiple files to one file input?▼

Yes, pass a list of absolute paths via the files parameter of browser_upload, for example files=["C:/a/one.png", "C:/a/two.png"]. The input must support multiple files, which you can check via its attributes from browser_find_elements.

Why does browser file upload fail silently?▼

Silent failures usually come from targeting the styled button instead of the real input, using a stale element index, or passing a relative or nonexistent path. Re-observe to get a fresh index and verify the file exists before uploading.

Does browser_upload open a native OS file picker?▼

No, browser_upload sets the input's files programmatically and never opens an OS file dialog. Do not wait for or attempt to interact with a native picker; provide the local path directly to the tool.