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.