agent-browser

Automate headless browser tasks using accessibility snapshots and ref-based element selection.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/vuxsoul-ui/catclash --skill agent-browser-vuxsoul-ui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/vuxsoul-ui/catclash/tree/main/skills/agent-browser-clawdbot
Command: npx skills add https://github.com/vuxsoul-ui/catclash --skill agent-browser-vuxsoul-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables reliable, repeatable browser automation for AI agents by driving a CLI tool that leverages accessibility tree snapshots and ref-based element selection, reducing manual web interactions.

Core Features & Use Cases

  • Deterministic element interactions via ref-based selectors for stable automation across complex SPAs.
  • Session isolation and multi-session testing to run parallel browser contexts without cross-contamination.
  • Snapshot-based state capture to support AI reasoning, debugging, and data extraction.
  • Use Case: Automate multi-step workflows such as form completion, navigation, and data gathering in AI agent workflows.

Quick Start

Open a site, snapshot the page, and interact with elements using their refs.

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 tasks with AI agents deterministically?

Browser automation for AI agents is achieved by driving a CLI that leverages accessibility tree snapshots and ref-based element selection, ensuring stable interactions. This approach enables deterministic navigation and multi-step workflows across dynamic web applications.

Can I run parallel browser automation sessions without cross-contamination?

Parallel browser automation sessions are fully supported through session isolation, allowing you to run multiple independent browser contexts simultaneously. This prevents cross-contamination and supports multi-session testing across different workflows.

How does ref-based element selection work for web automation?

Ref-based element selection in web automation works by capturing accessibility tree snapshots of the page, then using the assigned refs to interact with specific elements. This method provides deterministic targeting that remains stable across complex single-page application DOM changes.

What's the best way to capture browser page state for AI reasoning?

The best way to capture page state for AI reasoning is using snapshot-based state capture, which records the accessibility tree of the current browser session. These snapshots support AI decision-making, debugging, and data extraction during autonomous workflows.

Does this browser automation approach work with dynamic single-page applications?

Browser automation using accessibility snapshots and ref-based selectors works reliably with dynamic single-page applications. The snapshot approach decouples interactions from volatile DOM structures, ensuring stable multi-step navigation and form completion.

Why use accessibility snapshots instead of standard DOM selectors for web automation?

Accessibility snapshots are used instead of standard DOM selectors to provide deterministic, stable element selection for AI agents. This method reduces fragility from dynamic DOM changes, ensuring reliable repeatable browser automation and session isolation.