agent-browser

Automate browser interactions with ref-based element targeting and JSON snapshots.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates deterministic browser interactions for AI workflows by enabling ref-based element targeting and accessible-tree snapshots.

Core Features & Use Cases

  • Deterministic element targeting via refs for stable automation in dynamic SPAs
  • JSON-based interactive snapshots to guide AI decision-making
  • Session isolation, multi-tab/frame support, and comprehensive browser controls (open, navigate, click, fill, wait, screenshots, network control, cookies, storage)

Quick Start

Open https://example.com, take an interactive JSON snapshot, and identify the key ref names for the main call-to-action.

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 interactions for AI agents in dynamic SPAs?

Automating browser interactions for AI agents in dynamic SPAs requires deterministic element targeting via refs and accessible-tree snapshots to ensure repeatable actions. This Skill provides JSON-based interactive snapshots to guide AI decision-making in complex workflows.

What is ref-based element selection for headless browser automation?

Ref-based element selection for headless browser automation targets elements using stable reference names instead of fragile CSS selectors. This mechanism ensures repeatable targeting in multi-step workflows where DOM structures shift dynamically.

How do I take an interactive JSON snapshot of a headless browser session?

Taking an interactive JSON snapshot of a headless browser session captures the accessible tree and element refs for AI-driven decision making. The snapshot identifies key ref names for actions like clicking and filling form fields.

Can I isolate browser sessions and manage multiple tabs for automated testing?

Isolating browser sessions and managing multiple tabs for automated testing is supported through comprehensive browser controls. The Skill provides session isolation, multi-tab and multi-frame support, and state persistence capabilities.

Does headless browser automation work with network control and cookies for multi-step workflows?

Headless browser automation with network control and cookies supports multi-step workflows by allowing comprehensive browser controls. You can manage cookies, network traffic, and local storage while maintaining verifiable state across complex interactions.

What are the limitations of using accessible-tree snapshots for AI browser automation?

Using accessible-tree snapshots for AI browser automation may face limitations when handling elements not exposed in the accessibility tree. Complex SPAs with shadow DOM or canvas elements might require alternative targeting approaches if refs are unavailable.