Agent Browser Skill (Core)

Purpose

Provide an advanced, production-ready playbook for using agent-browser to automate web tasks via CLI and structured commands.

Best fit

• You need deterministic automation for AI agents.

• You want compact snapshots with refs and JSON output.

• You prefer a fast CLI with Node.js fallback.

Not a fit

• You require a full SDK or custom JS integration.

• You must stream large uploads or complex media workflows.

Quick orientation

• Read references/agent-browser-overview.md for install, architecture, and core concepts.

• Read references/agent-browser-command-map.md for command categories and flags.

• Read references/agent-browser-safety.md for high-risk controls and safe mode rules.

• Read references/agent-browser-workflows.md for recommended AI workflows.

• Read references/agent-browser-troubleshooting.md for common issues and fixes.

Required inputs

• Installed agent-browser CLI and browser runtime.

• Target URLs and workflow steps.

• Session or profile strategy if authentication is required.

Expected output

• A clear command sequence and operational guardrails for automation.

Operational notes

• Snapshot early, act via refs, then snapshot again after DOM changes.

• Use --json for machine parsing and scripting.

• Use waits and load-state checks before actions.

• Close tabs or sessions when done to release resources.

Safe mode defaults

• Do not use eval, --allow-file-access, custom --executable-path, or arbitrary --args without explicit approval.

• Avoid network route, set credentials, and cookie/storage mutations unless the task requires it.

• Allowlist domains and block localhost or private network targets.

Security notes

• Treat tokens and credentials as secrets.

• Avoid --allow-file-access unless explicitly required.