| name | agent-browser |
| description | Automate websites with the agent-browser CLI for navigation, form flows, screenshots, extraction, and repeatable browser tasks. Use when users ask to interact with web apps, gather evidence from pages, or run browser-based QA steps. |
| allowed-tools | bash sendMessage |
Browser Automation
Use this skill when work requires real browser interaction instead of API-only lookups.
Core Workflow
- Open target page:
- Capture interactive refs:
agent-browser snapshot -i
- Interact by ref:
agent-browser click @e1agent-browser fill @e2 "value"
- Re-snapshot after every navigation or significant DOM change:
agent-browser snapshot -i
- Capture result evidence:
agent-browser screenshot --annotate <file.png>
Operational Rules
- Use
agent-browser directly; do not use npx agent-browser.
- Prefer one named session for multi-step flows:
agent-browser --session <name> ...
- Use chained commands with
&& only when no intermediate output is needed.
- For commands that need refs (
@e*), run snapshot -i first and use fresh refs.
- If page load is async-heavy, wait explicitly:
agent-browser wait --load networkidle
- For user-facing findings, include screenshots and the exact page URL.
- When a user asks to see/share a screenshot in Slack, use
sendMessage with the screenshot path in files so the image is included in the active conversation.
- Never claim a screenshot was shared unless
sendMessage returned success in this turn.
- If
sendMessage is unavailable or file attachment fails, state the failure clearly and include the saved screenshot path or error instead of claiming success.
Common Patterns
Form flow
agent-browser --session demo open https://example.com/signup
agent-browser --session demo wait --load networkidle
agent-browser --session demo snapshot -i
agent-browser --session demo fill @e1 "user@example.com"
agent-browser --session demo click @e2
agent-browser --session demo wait --load networkidle
agent-browser --session demo screenshot --annotate /tmp/signup-result.png
Structured extraction
agent-browser open https://example.com
agent-browser snapshot --json > /tmp/page.json
agent-browser get text body > /tmp/page.txt
Reference Files
Read only what is needed:
Templates
