How do I install the Agent Browser skill?

Run npx skillmds@latest add knownasnaffy/agent-browser-7 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agent Browser safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Browser?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Browser free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Browser?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Browser by knownasnaffy — Agent Skill

Name: Agent Browser
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Agent Browser

Headless browser automation CLI for AI agents. Use when interacting with websites — navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, scraping, testing web apps, downloading files, or automating any browser task. Triggers on requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data", "test this web app", "login to a site", "monitor a page", or any task requiring programmatic web interaction.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Browser Automation with agent-browser

Setup

Run scripts/setup.sh to install agent-browser and Chromium. Requires Node.js.

Core Workflow

Every browser automation follows this pattern:

Navigate: agent-browser open <url>
Snapshot: agent-browser snapshot -i (get element refs like @e1, @e2)
Interact: Use refs to click, fill, select
Re-snapshot: After navigation or DOM changes, get fresh refs

agent-browser open https://example.com/form
agent-browser snapshot -i
# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"

agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i  # Check result

Command Chaining

Chain with && when you don't need intermediate output:

agent-browser open https://example.com && agent-browser wait --load networkidle && agent-browser snapshot -i

Run separately when you need to parse output first (e.g., snapshot to discover refs).

Essential Commands

# Navigate
agent-browser open <url>
agent-browser close

# See the page (always do this first)
agent-browser snapshot -i              # Interactive elements with refs
agent-browser snapshot -i -C           # Include onclick divs

# Interact using @refs
agent-browser click @e1
agent-browser fill @e2 "text"
agent-browser select @e1 "option"
agent-browser press Enter
agent-browser scroll down 500

# Get info
agent-browser get text @e1
agent-browser get url
agent-browser get title

# Wait
agent-browser wait @e1                 # For element
agent-browser wait --load networkidle  # For network idle

# Capture
agent-browser screenshot page.png
agent-browser screenshot --full        # Full page
agent-browser pdf output.pdf

For the full command reference, see references/commands.md.

Ref Lifecycle (Important)

Refs (@e1, @e2) are invalidated when the page changes. Always re-snapshot after:

Clicking links/buttons that navigate
Form submissions
Dynamic content loading (dropdowns, modals)

Common Patterns

Form Submission

agent-browser open https://example.com/signup
agent-browser snapshot -i
agent-browser fill @e1 "Jane Doe"
agent-browser fill @e2 "jane@example.com"
agent-browser select @e3 "California"
agent-browser click @e5
agent-browser wait --load networkidle

Login with State Persistence

agent-browser open https://app.example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "$USERNAME" && agent-browser fill @e2 "$PASSWORD"
agent-browser click @e3
agent-browser wait --url "**/dashboard"
agent-browser state save auth.json

# Reuse later
agent-browser state load auth.json
agent-browser open https://app.example.com/dashboard

Data Extraction

agent-browser open https://example.com/products
agent-browser snapshot -i
agent-browser get text @e5
agent-browser get text body > page.txt

Screenshot & Diff

agent-browser screenshot baseline.png
# ... changes happen ...
agent-browser diff screenshot --baseline baseline.png

Parallel Sessions

agent-browser --session site1 open https://site-a.com
agent-browser --session site2 open https://site-b.com
agent-browser session list

Security (Optional)

export AGENT_BROWSER_CONTENT_BOUNDARIES=1          # Wrap output for AI safety
export AGENT_BROWSER_ALLOWED_DOMAINS="example.com"  # Domain allowlist
export AGENT_BROWSER_MAX_OUTPUT=50000               # Prevent context flooding

Cleanup

Always close sessions when done: agent-browser close

---name: agent-browser-7description: Headless browser automation CLI for AI agents. Use when interacting with websites — navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, scraping, testing web apps, downloading files, or automating any browser task. Triggers on requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data", "test this web app", "login to a site", "monitor a page", or any task requiring programmatic web interaction.---# Browser Automation with agent-browser## SetupRun `scripts/setup.sh` to install agent-browser and Chromium. Requires Node.js.## Core WorkflowEvery browser automation follows this pattern:1. **Navigate**: `agent-browser open <url>`2. **Snapshot**: `agent-browser snapshot -i` (get element refs like `@e1`, `@e2`)3. **Interact**: Use refs to click, fill, select4. **Re-snapshot**: After navigation or DOM changes, get fresh refs```bashagent-browser open https://example.com/formagent-browser snapshot -i# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"agent-browser fill @e1 "user@example.com"agent-browser fill @e2 "password123"agent-browser click @e3agent-browser wait --load networkidleagent-browser snapshot -i # Check result```## Command ChainingChain with `&&` when you don't need intermediate output:```bashagent-browser open https://example.com && agent-browser wait --load networkidle && agent-browser snapshot -i```Run separately when you need to parse output first (e.g., snapshot to discover refs).## Essential Commands```bash# Navigateagent-browser open <url>agent-browser close# See the page (always do this first)agent-browser snapshot -i # Interactive elements with refsagent-browser snapshot -i -C # Include onclick divs# Interact using @refsagent-browser click @e1agent-browser fill @e2 "text"agent-browser select @e1 "option"agent-browser press Enteragent-browser scroll down 500# Get infoagent-browser get text @e1agent-browser get urlagent-browser get title# Waitagent-browser wait @e1 # For elementagent-browser wait --load networkidle # For network idle# Captureagent-browser screenshot page.pngagent-browser screenshot --full # Full pageagent-browser pdf output.pdf```For the full command reference, see `references/commands.md`.## Ref Lifecycle (Important)Refs (`@e1`, `@e2`) are invalidated when the page changes. Always re-snapshot after:- Clicking links/buttons that navigate- Form submissions- Dynamic content loading (dropdowns, modals)## Common Patterns### Form Submission```bashagent-browser open https://example.com/signupagent-browser snapshot -iagent-browser fill @e1 "Jane Doe"agent-browser fill @e2 "jane@example.com"agent-browser select @e3 "California"agent-browser click @e5agent-browser wait --load networkidle```### Login with State Persistence```bashagent-browser open https://app.example.com/loginagent-browser snapshot -iagent-browser fill @e1 "$USERNAME" && agent-browser fill @e2 "$PASSWORD"agent-browser click @e3agent-browser wait --url "**/dashboard"agent-browser state save auth.json# Reuse lateragent-browser state load auth.jsonagent-browser open https://app.example.com/dashboard```### Data Extraction```bashagent-browser open https://example.com/productsagent-browser snapshot -iagent-browser get text @e5agent-browser get text body > page.txt```### Screenshot & Diff```bashagent-browser screenshot baseline.png# ... changes happen ...agent-browser diff screenshot --baseline baseline.png```### Parallel Sessions```bashagent-browser --session site1 open https://site-a.comagent-browser --session site2 open https://site-b.comagent-browser session list```## Security (Optional)```bashexport AGENT_BROWSER_CONTENT_BOUNDARIES=1 # Wrap output for AI safetyexport AGENT_BROWSER_ALLOWED_DOMAINS="example.com" # Domain allowlistexport AGENT_BROWSER_MAX_OUTPUT=50000 # Prevent context flooding```## CleanupAlways close sessions when done: `agent-browser close`

Frequently asked questions