Agent skill

Agent Browser

by superagent-ai in superagent-ai/grok-cli

Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

MITAuto-check passedProductivity & Automation

Install Agent Browser

skills CLI
$ npx skills add superagent-ai/grok-cli --skill agent-browser -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install superagent-ai/grok-cli agent-browser --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/superagent-ai/grok-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-browser .claude/skills/agent-browser && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agent-browser
GitHub stars
3.5k
Token cost
~633 tokens
SKILL.md length
188 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

  • Works in 3 steps: Start the app with sandboxed bash. → Expose it through a forwarded localhost… → Use agent-browser against that localhost…
  • Tasks that involve Browser automation
  • SKILL.md covers Requirements, Core flow, Common commands and Guidance
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Browser is an agent skill from superagent-ai/grok-cli. Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Browser automation and QA and bug reports. The repository describes itself as: An open-source coding agent for the Grok API. The licence is MIT.

When your agent uses it

  • Tasks that involve Browser automation
  • Tasks that involve QA and bug reports

Example prompts

  • “/agent-browser”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Start the app with sandboxed bash.
  2. Expose it through a forwarded localhost port.
  3. Use agent-browser against that localhost URL.

What it can do on your machine

Read from SKILL.md and the folder at commit fb97af8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agent Browser loads about 633 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 188 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~633

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from superagent-ai/grok-cli at commit fb97af8, republished under its MIT licence (© superagent-ai). 188 words, ~633 tokens.

Download SKILL.mdSave it as .claude/skills/agent-browser/SKILL.md (or your agent's skills folder).
name
agent-browser
description
Use the host-side `agent-browser` CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

agent-browser

Use this skill when verification needs a real browser after the app is booted from the sandbox.

This project uses agent-browser on the host, not inside Shuru. The usual flow is:

  1. Start the app with sandboxed bash.
  2. Expose it through a forwarded localhost port.
  3. Use agent-browser against that localhost URL.

Requirements

  • The agent-browser CLI must be installed and available on PATH.
  • Prefer http://127.0.0.1:<port> or another explicit localhost URL.
  • Use a named browser session when there is any chance of concurrent runs.

Core flow

bash
agent-browser --session verify open http://127.0.0.1:3000
agent-browser --session verify wait --load networkidle
agent-browser --session verify snapshot -i

After any click or navigation, re-snapshot before using old refs again.

Common commands

bash
# Open and wait for readiness
agent-browser --session verify open <url>
agent-browser --session verify wait --load networkidle

# Inspect the page
agent-browser --session verify snapshot -i
agent-browser --session verify get title
agent-browser --session verify get url

# Interact with elements from snapshot refs
agent-browser --session verify click @e1
agent-browser --session verify fill @e2 "text"
agent-browser --session verify press Enter

# Record the smoke test as video
agent-browser record start .grok/verify-artifacts/verify-smoke.webm

# Capture screenshot proof (use --screenshot-dir, not a positional path)
mkdir -p .grok/verify-artifacts
agent-browser --screenshot-dir .grok/verify-artifacts screenshot
agent-browser --screenshot-dir .grok/verify-artifacts screenshot --full

# Stop recording and clean up
agent-browser record stop
agent-browser close

Guidance

  • Keep browser checks narrow in phase 1: page load, one or two critical controls, and optional screenshot evidence.
  • Save screenshots to stable workspace-relative paths under .grok/verify-artifacts/ so verify can report them back to the user.
  • Prefer wait --load networkidle after open.
  • If the page is dynamic, use snapshot -i again after each meaningful DOM change.
  • If the target URL is ambiguous because multiple forwarded ports exist, stop and report the ambiguity instead of guessing.
  • If agent-browser is unavailable, fall back to bash-only verification and say so clearly.

© superagent-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/agent-browser of superagent-ai/grok-cli.

Open the folder on GitHubat commit fb97af8

Compare with similar skills

Agent Browser next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agent Browser compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Browser this skillsuperagent-ai/grok-cli3.5k—~633Automated safety check: PassMIT
QAblueberrycongee/termcanvas406—~830Automated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Aside Browser Drivergarrytan/gstack136k—~8.1kAutomated safety check: NotesMIT
Browsemr-daedalium/ostack-saas1141 repos~5.3kAutomated safety check: NotesMIT
Pstackno-session/pstack131—~5.6kAutomated safety check: NotesMIT

Similar skills

  • QA

    blueberrycongee/termcanvas

    QA testing skill with real browser automation. An agent skill from blueberrycongee/termcanvas.

    406 GitHub stars~830 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Aside Browser Driver

    garrytan/gstack

    Drives a real browser through Aside so the agent can open a page, read it, click through a flow, take screenshots and check console errors.

    136k GitHub stars~8.1k tokensUpdated today
    Productivity & AutomationAuto-check: notes
  • Browse

    mr-daedalium/ostack-saas

    Fast headless browser for QA testing and site dogfooding. An agent skill from mr-daedalium/ostack-saas.

    114 GitHub starsUsed in 1 repo~5.3k tokens
    Productivity & AutomationAuto-check: notes
  • Pstack

    no-session/pstack

    Fast headless browser for QA testing and site dogfooding. An agent skill from no-session/pstack.

    131 GitHub stars~5.6k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes
  • Attaches OpenCode browser tools to the OpenWork Electron dev app through CDP to explore its UI, send a composer task and debug, not to give test verdicts.

    24k GitHub stars~780 tokensUpdated today
    Testing & QAAuto-check passed

More from superagent-ai/grok-cli

  • Agent Desktop

    superagent-ai/grok-cli

    Use the built-in Computer sub-agent with agent-desktop for macOS desktop automation.

    3.5k GitHub stars~720 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Agent Browser

What does Agent Browser do?

Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs. Agent Browser is an agent skill from superagent-ai/grok-cli. Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

When should I use Agent Browser?

Agent Browser fits situations like: tasks that involve Browser automation; tasks that involve QA and bug reports.

How do I install Agent Browser in Claude Code?

Run `npx skills add superagent-ai/grok-cli --skill agent-browser -a claude-code`. Or copy the skill folder (.agents/skills/agent-browser in superagent-ai/grok-cli) into .claude/skills/agent-browser in your project. Claude Code loads it when a task matches its description.

How do I install Agent Browser in Codex?

Run `npx skills add superagent-ai/grok-cli --skill agent-browser -a codex`. Or copy the skill folder (.agents/skills/agent-browser in superagent-ai/grok-cli) into .agents/skills/agent-browser in your project. Codex loads it when a task matches its description.

Can I use Agent Browser in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add superagent-ai/grok-cli --skill agent-browser -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-browser, .gemini/skills/agent-browser, .github/skills/agent-browser and .opencode/skills/agent-browser in your project.

What does Agent Browser need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Browser is instructions for the agent only.

Does Agent Browser access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agent Browser safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agent Browser use?

Agent Browser is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Browser use?

About 633 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Browser?

Skills that share tags, products or a category with Agent Browser: QA (blueberrycongee/termcanvas, 406 stars), Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Aside Browser Driver (garrytan/gstack, 136k stars) and Browse (mr-daedalium/ostack-saas, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Browser?

superagent-ai (a GitHub organization) maintains it in superagent-ai/grok-cli, which has 3,487 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 6, 2026.

Source: superagent-ai/grok-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.