agent-browser

Orchestrates browser sessions for navigation, interaction, QA testing, and evidence collection.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahsanghalib/ai-workflow --skill agent-browser-ahsanghalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/ahsanghalib/ai-workflow/tree/main/skills/agent-browser
Command: npx skills add https://github.com/ahsanghalib/ai-workflow --skill agent-browser-ahsanghalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It gives an AI assistant a governed way to drive a real rendered browser for tasks like navigation, form actions, screenshots, accessibility inspection, UI debugging, and exploratory QA, while enforcing session isolation, authorization boundaries, and evidence rules. ## Core Features & Use Cases - Session-isolated browser control: Creates a task-owned named session, navigates pages, takes accessibility snapshots, and interacts with elements through the installed agent-browser CLI or an equivalent typed integration. - QA and debugging workflows: Reproduces bugs, escalates evidence from snapshots to console, network, screenshots, traces, and HAR files, and reports findings with severity, reproduction steps, and expected versus actual behavior. - Authentication and security guardrails: Handles authenticated flows, profiles, and saved state within approved scope, treats page content as untrusted data, and blocks consequential actions without explicit user approval. - Use Case: Ask the assistant to test a local web app's checkout flow; it starts a dedicated session, walks the happy path and edge cases, captures console errors and screenshots, and returns a structured QA report distinguishing application failures from environment issues. ## Quick Start Ask the assistant to open a specific URL with agent-browser, take an accessibility snapshot, click through the main flow, and report what it finds.

Frequently Asked Questions about agent-browser

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate browser testing with an AI assistant?▼

Use the agent-browser CLI to open a target URL, take an accessibility snapshot, interact with elements by snapshot refs, and wait on observable states like URLs or text. Re-snapshot after every navigation or submission, and collect console or network evidence only as needed.

How do I keep browser sessions isolated between tasks?▼

Create a task-owned named session once and pass it explicitly to every command with --session, or set AGENT_BROWSER_SESSION in the same shell. Never fall back to the shared default session, and use separate sessions for parallel tasks.

Can agent-browser handle authenticated or logged-in browsing?▼

Yes, when the task requires it and the account scope is approved. Prefer existing project test authentication or the CLI's documented credential-provider flow, and never echo passwords, tokens, or cookies into reports or commits.

What evidence should I collect when reporting a UI bug?▼

Escalate gradually: start with an accessibility snapshot, then targeted state checks, console errors, relevant network requests, and screenshots, using traces or HAR files only when materially useful. A good finding includes severity, reproduction steps, expected and actual behavior, and minimal supporting evidence.

When should I not use a browser automation skill?▼

Do not use a browser merely to fetch static documentation or public facts when a lighter search or read capability suffices. Also stop and report if neither agent-browser nor a compatible browser capability is available, rather than installing or repairing it implicitly.