What this skill does
Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
What it does
Web browser automation with AI-optimized snapshots for claude-flow agents
When to use it
The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.
How agents load it
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Browser Automation Skill; Core Workflow; 1. Navigate to page; 2. Get accessibility tree with element refs; 3. Interact using refs from snapshot; 4. Re-snapshot after page changes. It includes spec-recommended sections: step-by-step instructions.
File analysis
File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.
Browser Automation Skill Core Workflow 1. Navigate to page 2. Get accessibility tree with element refs 3. Interact using refs from snapshot 4. Re-snapshot after page changes Quick Reference Navigation Snapshots (AI-Optimized) Interaction Get Info Wait
Source category:skills.sh agent-skill
Sources & links
namebrowser
descriptionWeb browser automation with AI-optimized snapshots for claude-flow agents
Discover The client exposes names and descriptions to the agent.
Activate Your request or the task context selects the skill and loads its instructions.
Load resources Referenced scripts, documentation and assets are used when needed.
Invocation syntax and available tools depend on your Agent client. Client integration guide ↗
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
Ask your Agent to install
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "browser" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-32dea128be405c9b-Browser.html
Save it as .cursor/skills/browser/SKILL.md or .claude/skills/browser/SKILL.md and keep the frontmatter name and description exactly as-is.
Copy install prompt Full package on GitHub ↗
Install from the terminal · Skills CLI
Requires Node.js and npx. First inspect the repository's skill list to confirm the name.
npx skills add 'https://github.com/ruvnet/ruflo' --list
Copy discovery command
Target agent
Choose interactively Codex Claude Code Cursor
Installation scope
This project All my projects
npx skills add 'https://github.com/ruvnet/ruflo' --skill 'browser' Copy install command
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
SKILL.md source Copy freely; the source file is unchanged
Copy SKILL.md
Reset
Found this skill helpful?
Readable layout
---
name: browser
description: Web browser automation with AI-optimized snapshots for claude-flow agents
version: 1.0.0
triggers:
- /browser
- browse
- web automation
- scrape
- navigate
- screenshot
tools:
- browser/open
- browser/snapshot
- browser/click
- browser/fill
- browser/screenshot
- browser/close
---
# Browser Automation Skill
Web browser automation using agent-browser with AI-optimized snapshots. Reduces context by 93% using element refs (@e1, @e2) instead of full DOM.
## Core Workflow
```bash
# 1. Navigate to page
agent-browser open
# 2. Get accessibility tree with element refs
agent-browser snapshot -i # -i = interactive elements only
# 3. Interact using refs from snapshot
agent-browser click @e2
agent-browser fill @e3 "text"
# 4. Re-snapshot after page changes
agent-browser snapshot -i
```
## Quick Reference
### Navigation
| Command | Description |
|---------|-------------|
| `open ` | Navigate to URL |
| `back` | Go back |
| `forward` | Go forward |
| `reload` | Reload page |
| `close` | Close browser |
### Snapshots (AI-Optimized)
| Command | Description |
|---------|-------------|
| `snapshot` | Full accessibility tree |
| `snapshot -i` | Interactive elements only (buttons, links, inputs) |
| `snapshot -c` | Compact (remove empty elements) |
| `snapshot -d 3` | Limit depth to 3 levels |
| `screenshot [path]` | Capture screenshot (base64 if no path) |
### Interaction
| Command | Description |
|---------|-------------|
| `click ` | Click element |
| `fill ` | Clear and fill input |
| `type ` | Type with key events |
| `press ` | Press key (Enter, Tab, etc.) |
| `hover ` | Hover element |
| `select ` | Select dropdown option |
| `check/uncheck ` | Toggle checkbox |
| `scroll [px]` | Scroll page |
### Get Info
| Command | Description |
|---------|-------------|
| `get text ` | Get text content |
| `get html ` | Get innerHTML |
| `get value ` | Get input value |
| `get attr ` | Get attribute |
| `get title` | Get page title |
| `get url` | Get current URL |
### Wait
| Command | Description |
|---------|-------------|
| `wait ` | Wait for element |
| `wait ` | Wait milliseconds |
| `wait --text "text"` | Wait for text |
| `wait --url "pattern"` | Wait for URL |
| `wait --load networkidle` | Wait for load state |
### Sessions
| Command | Description |
|---------|-------------|
| `--session ` | Use isolated session |
| `session list` | List active sessions |
## Selectors
### Element Refs (Recommended)
```bash
# Get refs from snapshot
agent-browser snapshot -i
# Output: button "Submit" [ref=e2]
# Use ref to interact
agent-browser click @e2
```
### CSS Selectors
```bash
agent-browser click "#submit"
agent-browser fill ".email-input" "
[email protected] "
```
### Semantic Locators
```bash
agent-browser find role button click --name "Submit"
agent-browser find label "Email" fill "
[email protected] "
agent-browser find testid "login-btn" click
```
## Examples
### Login Flow
```bash
agent-browser open https://example.com/login
agent-browser snapshot -i
agent-browser fill @e2 "
[email protected] "
agent-browser fill @e3 "password123"
agent-browser click @e4
agent-browser wait --url "**/dashboard"
```
### Form Submission
```bash
agent-browser open https://example.com/contact
agent-browser snapshot -i
agent-browser fill @e1 "John Doe"
agent-browser fill @e2 "
[email protected] "
agent-browser fill @e3 "Hello, this is my message"
agent-browser click @e4
agent-browser wait --text "Thank you"
```
### Data Extraction
```bash
agent-browser open https://example.com/products
agent-browser snapshot -i
# Iterate through product refs
agent-browser get text @e1 # Product name
agent-browser get text @e2 # Price
agent-browser get attr @e3 href # Link
```
### Multi-Session (Swarm)
```bash
# Session 1: Navigator
agent-browser --session nav open https://example.com
agent-browser --session nav state save auth.json
# Session 2: Scraper (uses same auth)
agent-browser --session scrape state load auth.json
agent-browser --session scrape open https://example.com/data
agent-browser --session scrape snapshot -i
```
## Integration with Claude Flow
### MCP Tools
All browser operations are available as MCP tools with `browser/` prefix:
- `browser/open`
- `browser/snapshot`
- `browser/click`
- `browser/fill`
- `browser/screenshot`
- etc.
### Memory Integration
```bash
# Store successful patterns
npx @claude-flow/cli memory store --namespace browser-patterns --key "login-flow" --value "snapshot->fill->click->wait"
# Retrieve before similar task
npx @claude-flow/cli memory search --query "login automation"
```
### Hooks
```bash
# Pre-browse hook (get context)
npx @claude-flow/cli hooks pre-edit --file "browser-task.ts"
# Post-browse hook (record success)
npx @claude-flow/cli hooks post-task --task-id "browse-1" --success true
```
## Tips
1. **Always use snapshots** - They're optimized for AI with refs
2. **Prefer `-i` flag** - Gets only interactive elements, smaller output
3. **Use refs, not selectors** - More reliable, deterministic
4. **Re-snapshot after navigation** - Page state changes
5. **Use sessions for parallel work** - Each session is isolated
Related skills
Agent Workflows
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that exte…
Agent Workflows
Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fl…
Agent Workflows
Orchestrate multi-agent teams with defined roles, task lifecycles, handoff protocols, and review workflows. Use when: (1) Setting up a team …
Agent Workflows
Spec-first, TDD, subagent-driven software development workflow. Use when: (1) building any new feature or app — triggers brainstorm → plan →…