maxwell2732/claudecode-research-harness-workflow/agent-browser

Agent Browser Skill

A skill for browser automation. Uses the agent-browser CLI to perform UI debugging, verification, and automated interaction.

Trigger Phrases

This skill is automatically invoked by the following phrases:

• "Open this page", "Check the URL"
• "Click on", "Type into", "Fill the form"
• "Take a screenshot"
• "Check the UI", "Test the screen"
• "open this page", "click on", "fill the form", "screenshot"

Features

Execution Steps

Step 0: Verify agent-browser

# Check installation
which agent-browser
 
# If not installed
npm install -g agent-browser
agent-browser install

Step 1: Classify the User's Request

Step 2: AI Snapshot Workflow (Recommended)

For most operations, first take a snapshot and then interact using element references:

# 1. Open the page
agent-browser open https://example.com
 
# 2. Take a snapshot (AI-optimized, interactive elements only)
agent-browser snapshot -i -c
 
# Sample output:
# - link "Home" [ref=e1]
# - button "Login" [ref=e2]
# - input "Email" [ref=e3]
# - input "Password" [ref=e4]
# - button "Submit" [ref=e5]
 
# 3. Interact via element references
agent-browser click @e2           # Click Login button
agent-browser fill @e3 "user@example.com"
agent-browser fill @e4 "password123"
agent-browser click @e5           # Submit

Step 3: Verify the Result

# Check current state via snapshot
agent-browser snapshot -i -c
 
# Or check the URL
agent-browser get url
 
# Take a screenshot
agent-browser screenshot result.png

Quick Reference

Basic Operations

Navigation

Retrieving Information

Waiting

Debugging

Session Management

Manage multiple tabs/sessions in parallel:

# Specify a session
agent-browser --session admin open https://admin.example.com
agent-browser --session user open https://example.com
 
# List sessions
agent-browser session list
 
# Operate in a specific session
agent-browser --session admin snapshot -i -c

Choosing Between agent-browser and MCP Browser Tools

Principle: Try agent-browser first; use MCP tools only if it doesn't work.

Notes

• agent-browser runs in headless mode by default
• Use --headed to show the browser
• Sessions persist until explicitly closed
• Use sessions for sites requiring authentication