agent-browser
Skill2 starsChanged 54 days agoApache-2.0View on GitHub
A comprehensive skill for using agent-browser, a CLI tool for browser automation designed for AI agents, developed by Vercel Labs. This skill covers installation, core commands, selectors (refs, CSS, XPath, semantic locators), agent mode, sessions, options, and best practices. Use this skill whenever the user needs to automate browser interactions via CLI commands, especially for AI agents that need to interact with web pages.
188 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- chrysogonus/power-agentstheir own version, first seen Nov 8, 2026
- kinhluan/skillstheir own version, first seen Nov 8, 2026
- cafe3310/public-agent-skillstheir own version, first seen Nov 8, 2026
- kortix-ai/sunatheir own version, first seen Nov 8, 2026
- HeteroCat/heterocat-skillstheir own version, first seen Nov 8, 2026
- JuanMarchetto/agent-skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use time-skill, dep-refs and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Recepay6358Skilltime-skill
Display the current time in Pakistan Standard Time (PKT, UTC+5). Use when the user asks for the current time, Pakistan time, or PKT.
Also in 6 projects that use this
betacatslingSkilldep-refs
Use when needs to inspect TypeScript export references in the z-code workspace, list exports from a file, verify whether an export is unused before deletion, investigate who imports a symbol during refactors, or combine pnpm knip unused-export results with pnpm dep:refs symbol-level reference tracing.
Also in 5 projects that use this
- betacatslingSkill
feature-boundary-planner
Map a ZCode behavior change to current UI surfaces, state owners, protocol commands, persistence, and validation. Use for impact analysis, product-boundary planning, or an implementation handoff grounded in the checked-out source.
Also in 5 projects that use this
nicepkgSkillcommunity-led-growth
Expert in community-led growth (CLG) - leveraging user communities to drive acquisition, retention, and expansion. Covers building developer communities, user groups, ambassador programs, and turning customers into advocates. Knows the difference between community as a feature vs community as a growth engine, and how to measure community ROI. Use when "community-led, CLG, ambassador program, champion program, user community, developer community, word of mouth, user group, " mentioned.
Also in 5 projects that use this
- nicepkgSkill
ph-community-outreach
Engage Reddit, Indie Hackers, Hacker News and other communities for Product Hunt launches. Use this skill to identify relevant communities, craft appropriate posts, and drive cross-platform engagement without appearing spammy.
Also in 5 projects that use this
- Recepay6358Skill
weather-svg-creator
Creates an SVG weather card showing the current temperature for Dubai. Writes the SVG to orchestration-workflow/weather.svg and updates orchestration-workflow/output.md.
Also in 6 projects that use this
- +3 more from nicepkg
Other versions188 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- secondorderai/ouroboros★ 382% same
Wrote their own version · 187
- shanraisshan/claude-code-best-practice★ 69ksame name
- moeru-ai/airi★ 51ksame name
- vercel-labs/agent-browser★ 47ksame name
- activepieces/activepieces★ 25ksame name
- slopus/happy★ 25ksame name
- kortix-ai/suna★ 21ksame name
- kortix-ai/CompanyOS★ 21ksame name
- eosphoros-ai/DB-GPT★ 20ksame name
- documenso/documenso★ 16ksame name
- emdash-cms/emdash★ 14ksame name
177 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository19 other files it gives its agents.
- openspec-apply-changeSkill
- openspec-archive-changeSkill
- openspec-exploreSkill
- openspec-proposeSkill
- agent-plugins-skillSkill
- autoresearchSkill
- browser-traceSkill
- cavemanSkill
- codebase-designSkill
- code-generatorSkill
- codegraphSkill
- mcp-builderSkill
- skill-awesomeSkill
- skill-creatorSkill
- skill-installerSkill
- skill-official-evaluationSkill
- skill-sop-creatorSkill
- skill-trace-checkerSkill
- skill-trace-evaluationSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. 0 are common, 11 are distinctive, and 8 are very specific to this project.
0
Common
Most of the 172 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Use this skill whenever the user wants to:
- Distinctive: line 10
Use browser automation for AI agents
- Distinctive: line 12
Use refs-based element selection for deterministic automation
- Distinctive: line 16
Use semantic locators for more reliable element selection
- Distinctive: line 20
Use authenticated sessions with custom headers
- Distinctive: line 77
Reference API documentation: when needed:
- Distinctive: line 97
Follow the instructions, syntax, and best practices in that file
- Distinctive: line 112
Use Refs: Prefer refs (@e1, @e2) over traditional selectors for deterministic automation
- Distinctive: line 113
Snapshot First: Always snapshot before interacting with elements to get refs
- Very specific: line 114
Agent Mode: Use --json flag for machine-readable output in agent mode
- Very specific: line 115
Session Management: Use --session to maintain state across commands
- Very specific: line 116
Interactive Snapshot: Use -i flag for interactive snapshot selection
- Distinctive: line 117
Semantic Locators: Use semantic locators (role/name) when refs are not available
- Distinctive: line 118
Error Handling: Check command exit codes and error messages
- Very specific: line 120
Headed Mode: Use --headed for debugging, headless for production
- Very specific: line 121
CDP Integration: Use --cdp for Chrome DevTools Protocol integration
- Very specific: line 122
Streaming: Use AGENT_BROWSER_STREAM_PORT for live browser preview
- Very specific: line 123
Authenticated Sessions: Use --headers for authentication without login flows
- Very specific: line 124
Custom Executable: Use --executable-path for serverless deployments or custom browsers
“Common” is measured: kept by at least 6 in 10 of the 172 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
When to use this skill
Use this skill whenever the user wants to:
- Automate browser interactions via CLI commands
- Use browser automation for AI agents
- Navigate websites and interact with pages using command-line tools
- Use refs-based element selection for deterministic automation
- Integrate browser automation into AI agent workflows
- Capture snapshots of web pages with accessibility trees
- Fill forms, click elements, and extract content via CLI
- Use semantic locators for more reliable element selection
- Work with browser automation in agent mode with JSON output
- Manage multiple browser sessions
- Debug browser automation with headed mode
- Use authenticated sessions with custom headers
- Connect to existing browsers via CDP
- Stream browser viewport for live preview
How to use this skill
This skill is organized to match the agent-browser official documentation structure (https://github.com/vercel-labs/agent-browser/blob/main/README.md). When working with agent-browser:
- Install agent-browser:
- Load
examples/getting-started/installation.mdfor installation instructions
- Load
- Quick Start:
- Load
examples/quick-start/quick-start.mdfor basic workflow examples
- Load
- Learn core commands:
- Load
examples/commands/basic-commands.mdfor basic commands (open, click, fill, etc.) - Load
examples/commands/advanced-commands.mdfor advanced commands (snapshot, eval, etc.) - Load
examples/commands/get-info/for information retrieval commands - Load
examples/commands/check-state/for state checking commands - Load
examples/commands/find-elements/for semantic locator commands - Load
examples/commands/wait/for wait commands - Load
examples/commands/mouse-control/for mouse control commands - Load
examples/commands/browser-settings/for browser configuration - Load
examples/commands/cookies-storage/for cookies and storage management - Load
examples/commands/network/for network interception - Load
examples/commands/tabs-windows/for tab and window management - Load
examples/commands/frames/for iframe handling - Load
examples/commands/dialogs/for dialog handling - Load
examples/commands/debug/for debugging commands - Load
examples/commands/navigation/for navigation commands - Load
examples/commands/setup/for setup commands
- Load
- Understand selectors:
- Load
examples/selectors/refs.mdfor refs-based selection (@e1, @e2, etc.) - Load
examples/selectors/traditional-selectors.mdfor CSS, XPath, and semantic locators
- Load
- Use agent mode:
- Load
examples/agent-mode/introduction.mdfor agent mode overview - Load
examples/agent-mode/optimal-workflow.mdfor optimal AI workflow - Load
examples/agent-mode/integration.mdfor integrating with AI agents
- Load
- Advanced features:
- Load
examples/advanced/sessions.mdfor session management - Load
examples/advanced/headed-mode.mdfor debugging with visible browser - Load
examples/advanced/authenticated-sessions.mdfor authentication via headers - Load
examples/advanced/custom-executable.mdfor custom browser executable - Load
examples/advanced/cdp-mode.mdfor Chrome DevTools Protocol integration - Load
examples/advanced/streaming.mdfor browser viewport streaming - Load
examples/advanced/architecture.mdfor architecture overview - Load
examples/advanced/platforms.mdfor platform support - Load
examples/advanced/usage-with-agents.mdfor AI agent integration patterns
- Load
- Configure options:
- Load
examples/options/global-options.mdfor global CLI options - Load
examples/options/snapshot-options.mdfor snapshot-specific options - Load
examples/options/session-options.mdfor session management options
- Load
- Reference API documentation when needed:
api/commands.md- Complete command referenceapi/selectors.md- Selector referenceapi/options.md- Options reference
- Use templates for quick start:
templates/basic-automation.md- Basic automation workflowtemplates/ai-agent-workflow.md- AI agent workflow template
Doc mapping (one-to-one with official documentation)
- See examples and API files → https://github.com/vercel-labs/agent-browser
Examples and Templates
This skill includes detailed examples organized to match the official documentation structure. All examples are in the examples/ directory (see mapping above).
To use examples:
- Identify the topic from the user's request
- Load the appropriate example file from the mapping above
- Follow the instructions, syntax, and best practices in that file
- Adapt the code examples to your specific use case
To use templates:
- Reference templates in
templates/directory for common scaffolding - Adapt templates to your specific needs and coding style
API Reference
- Commands API:
api/commands.md- Complete command reference with syntax and examples - Selectors API:
api/selectors.md- Selector types and usage reference - Options API:
api/options.md- All options reference
Best Practices
- Use Refs: Prefer refs (@e1, @e2) over traditional selectors for deterministic automation
- Snapshot First: Always snapshot before interacting with elements to get refs
- Agent Mode: Use
--jsonflag for machine-readable output in agent mode - Session Management: Use
--sessionto maintain state across commands - Interactive Snapshot: Use
-iflag for interactive snapshot selection - Semantic Locators: Use semantic locators (role/name) when refs are not available
- Error Handling: Check command exit codes and error messages
- Wait for Navigation: Commands automatically wait for navigation to complete
- Headed Mode: Use
--headedfor debugging, headless for production - CDP Integration: Use
--cdpfor Chrome DevTools Protocol integration - Streaming: Use
AGENT_BROWSER_STREAM_PORTfor live browser preview - Authenticated Sessions: Use
--headersfor authentication without login flows - Custom Executable: Use
--executable-pathfor serverless deployments or custom browsers - Snapshot Options: Combine
-i,-c,-d,-soptions to optimize snapshot output
Resources
- GitHub Repository: https://github.com/vercel-labs/agent-browser
- Official README: https://github.com/vercel-labs/agent-browser/blob/main/README.md
- Agent Mode Documentation: https://agent-browser.dev/agent-mode
- Issues: https://github.com/vercel-labs/agent-browser/issues
Keywords
agent-browser, CLI browser automation, AI agents, browser automation CLI, refs, snapshot, agent mode, semantic locators, browser automation tool, command-line browser, AI agent browser, deterministic selectors, accessibility tree, browser commands, web automation CLI, sessions, headed mode, authenticated sessions, CDP mode, streaming, Chrome DevTools Protocol, Playwright, browser automation for AI
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.