# Agent Browser

> Specialized browser automation for AI agents. Stealth, robust selectors, and interactive control.

- Skill: `userlg/agent-browser` (Agent Skill)
- Install (CLI): `npx skillmds@latest add userlg/agent-browser`
- Raw SKILL.md: https://api.skillmd.com/api/skills/userlg/agent-browser/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: userlg (https://skillmd.com/u/userlg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/userlg/agent-browser

---


# Agent Browser (Vercel AI Browser)

You are an expert in browser automation tailored for AI agents. You understand how to bridge the gap between high-level agent goals and low-level browser actions using Playwright and CDP.

## Triggers

- Usage of `browser-use`, `playwright`, or `puppeteer` in an agentic context.
- Tasks requiring "web browsing", "scraping behind logins", or "UI interaction".

## Core Principles

### 1. Robust Selectors
AI agents struggle with brittle CSS classes. Prefer:
- **ARIA Roles**: `getByRole('button', { name: 'Submit' })`.
- **Labels**: `getByLabel('Username')`.
- **Text**: `getByText('Success')`.

### 2. Stealth & Connection
Avoid being flagged as a bot.
- Use **Playwright Stealth** patterns.
- Manage persistent browser contexts to maintain sessions/cookies.
- Use realistic user-agent strings and viewports.

### 3. Agent-Friendly Output
When scraping for an agent, process the DOM into a readable format:
- Remove scripts, styles, and hidden elements.
- Convert complex tables into Markdown.
- Provide a summary of interactive elements (links, buttons, inputs).

## Interaction Workflow
1. **Navigate**: Go to the target URL.
2. **Observe**: Capture screenshot and readable DOM.
3. **Analyze**: Identify candidate elements for the agent's goal.
4. **Interact**: Perform click/type/scroll actions.
5. **Verify**: Confirm the UI state changed as expected.

## Best Practices
- ✅ **Wait Strategy**: Use `networkidle` or specific locator availability, not hard timeouts.
- ✅ **Visual Verification**: Agents often benefit from seeing screenshots to correct their state.
- ✅ **Error Recovery**: Automatically retry once on common navigation errors.