ui-test
AI-powered adversarial UI testing via the browse CLI. Analyzes git diffs to test only what changed, or explores the full app to find bugs. Tests functional correctness, accessibility, responsive layout, and UX heuristics
Install / Use
npx skills add browserbase/skills --skill ui-testInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Our assessment of ui-test
ui-test scores 95/100 on our quality scale, 102nd of 745 Operations skills we index (top 14%).
Its SKILL.md is 28 KB long, well organised into 75 sections with 22 code examples: a thorough specification that gives an agent plenty to work with.
With 3,731 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so ui-test is actively maintained.
- Our last check on 2026-11-16 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill tells the agent to add `Bash(browse:*)` and `Bash(BROWSE_SESSION=*)` to `.claude/settings.json` 'permissions.allow' to avoid approval prompts, which is adding itself to a permission allow-list and weakens safeguards.
AI review: risky
- The skill tells the agent to add `Bash(browse:*)` and `Bash(BROWSE_SESSION=*)` to `.claude/settings.json` 'permissions.allow' to avoid approval prompts, which is adding itself to a permission allow-list and weakens safeguards.
- It instructs the agent to run `npm install -g browse` and to execute many `browse` CLI commands, all part of its legitimate UI-testing purpose but with broad Bash permissions.
- It includes targeted process-killing commands (`pkill -f 'browse.*daemon'`) for troubleshooting, which are destructive but narrowly scoped to the tool's own daemons.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
ui-test compared with similar skills
All 4 of these similar skills score higher than ui-test; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| ui-test (this skill)by browserbase | 95 | 3.7k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install ui-test?
- Run
npx skills add browserbase/skills --skill ui-test. The install tabs above show the steps for each supported agent. - Which AI agents does ui-test work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is ui-test safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill tells the agent to add
Bash(browse:*)andBash(BROWSE_SESSION=*)to.claude/settings.json'permissions.allow' to avoid approval prompts, which is adding itself to a permission allow-list and weakens safeguards. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand. - Is ui-test still maintained?
- The repository was last updated about 2 months ago, so ui-test is actively maintained.
Skill content
View source on GitHubname: ui-test
description: "AI-powered adversarial UI testing via the browse CLI. Analyzes git diffs to test only what changed, or explores the full app to find bugs. Tests functional correctness, accessibility, responsive layout, and UX heuristics. Use when the user asks to test UI changes, QA a pull request, audit accessibility, or run exploratory testing. Supports local browser (localhost) and remote Browserbase (deployed sites)."
license: MIT
metadata:
author: browserbase
version: "0.4.0"
allowed-tools: Bash Read Glob Grep Agent
compatibility: "Requires the browse CLI (npm install -g browse). For remote testing: BROWSERBASE_API_KEY and cookie-sync skill."
UI Test — Agentic UI Testing Skill
Test UI changes in a real browser. Your job is to try to break things, not confirm they work.
Three workflows:
- Diff-driven — analyze a git diff, test only what changed
- Exploratory — navigate the app, find bugs the developer didn't think about
- Parallel — fan out independent test groups across multiple Browserbase browsers
How Testing Works
The main agent coordinates — it plans test strategy, delegates to sub-agents, and merges results. Sub-agents do the actual browser testing.
Planning: multiple angles, then execute once
You MUST complete all three planning rounds yourself and output them before launching any sub-agents. Planning happens in your own response — it is NOT delegated to sub-agents. Do not skip ahead to execution.
Round 1 — Functional: What are the core user flows? What should work? Write out each test as: action → expected result.
Round 2 — Adversarial: Re-read Round 1. What did you miss? Think about: different user types/roles, error paths, empty states, race conditions, edge inputs (empty, huge, special chars, rapid clicks).
Round 3 — Coverage gaps: Re-read Rounds 1–2. What about: accessibility (axe-core, keyboard-only), mobile viewports, console errors, visual consistency with the rest of the app?
Deduplicate: Merge all three rounds into one numbered list of tests. Remove overlaps. Assign each test to a group (e.g. Group A, Group B).
Then execute once — launch one sub-agent per group. Each sub-agent receives its specific list of tests to run, nothing more. Sub-agents do not explore or plan — they execute assigned tests and report results.
Output the three rounds, the merged plan, and the group assignments in your response before calling any Agent tool.
Principles for splitting work
- Sub-agents run assigned tests, not open exploration. The main agent hands each sub-agent a specific numbered list of tests. Sub-agents do not plan, explore, or decide what to test — they execute the list and stop.
- The bottleneck is the slowest agent — split work so no single agent has a disproportionate share. Many small agents > few large ones.
- Size the effort to the change — a single component fix doesn't need many agents or many steps. A full-page redesign does. Let the scope of the diff drive the plan.
- No early stopping on failures — find as many bugs as possible within the assigned tests.
Giving sub-agents a step budget
The main agent MUST include an explicit browse step limit in every sub-agent prompt. Sub-agents do not self-limit — they will run until done unless told otherwise.
As a rough heuristic: ~25 steps for a few targeted checks, ~40 for a full page with functional + adversarial + a11y, ~75 for multiple pages or a broad category. Adjust based on what the assigned tests actually require — these are starting points, not rules.
As a rough heuristic: ~25 steps for a few targeted checks, ~40 for a full page with functional + adversarial + a11y, ~75 for multiple pages or a broad category. Adjust based on what the assigned tests actually require — these are starting points, not rules.
Every sub-agent prompt must include:
You have a budget of N browse steps (each `browse` command = 1 step). Count your steps as you go. When you reach N, stop immediately and report:
- STEP_PASS/STEP_FAIL for every test you completed
- STEP_SKIP|<test-id>|budget reached for every test you didn't get to
Do not retry or continue after hitting the budget.
Run only these tests: [numbered list from the merged plan]
Do not explore beyond the assigned tests.
Do NOT generate an HTML report or write any files. Return only step markers and your findings as text.
The main agent should NOT run browse commands itself (except to verify the dev server is up). All testing happens in sub-agents.
When a sub-agent hits its budget, the main agent accepts the partial results as-is. Do not re-run or retry the sub-agent. Include SKIPPED tests in the final report so the developer knows what wasn't covered.
Reporting
Every sub-agent reports back with:
Tests: 8 | Passed: 5 | Failed: 2 | Skipped: 1 | Pages visited: 2
The main agent merges into a final report with:
Tests: 20 | Passed: 14 | Failed: 4 | Skipped: 2 | Agents: 3 | Pass rate: 70%
Do not report "steps used" — browse command counts are implementation plumbing, not a meaningful metric for reviewers.
Testing Philosophy
You are an adversarial tester. Your goal is to find bugs, not prove correctness.
- Try to break every feature you test. Don't just check "does the button exist?" — click it twice rapidly, submit empty forms, paste 500 characters, press Escape mid-flow.
- Test what the developer didn't think about. Empty states, error recovery, keyboard-only navigation, mobile overflow.
- Every assertion must be evidence-based. Compare before/after snapshots. Check specific elements by ref. Never report PASS without concrete evidence from the accessibility tree or a deterministic check.
- Report failures with enough detail to reproduce. Include the exact action, what you expected, what you got, and a suggested fix.
Assertion Protocol
Every test step MUST produce a structured assertion. Do not write freeform "this looks good."
Step markers
For each test step, emit exactly one marker:
STEP_PASS|<step-id>|<evidence>
or
STEP_FAIL|<step-id>|<expected> → <actual>|<screenshot-path>
step-id: short identifier likehomepage-cta,form-validation-error,modal-cancelevidence: what you observed that proves the step passed (element ref, text content, URL, eval result)expected → actual: what you expected vs what you gotscreenshot-path: path to the saved screenshot (failures only — see Screenshot Capture below)
Screenshot Capture for Failures
Every STEP_FAIL MUST have an accompanying screenshot so the developer can see what went wrong visually.
When a test step fails:
# 1. Take a screenshot immediately after observing the failure
browse screenshot --path .context/ui-test-screenshots/<step-id>.png
# If --path is not supported, take the screenshot and save manually:
browse screenshot
# The browse CLI will output the screenshot path — move/copy it:
cp /tmp/browse-screenshot-*.png .context/ui-test-screenshots/<step-id>.png
Setup the screenshot directory at the start of any test run:
mkdir -p .context/ui-test-screenshots
Rules:
- File name = step-id (e.g.,
double-submit.png,axe-audit.png,modal-focus-trap.png) - Store in
.context/ui-test-screenshots/— this directory is gitignored and accessible to the developer and other agents - For parallel runs, include the session name:
<session>-<step-id>.png(e.g.,signup-double-submit.png) - Take the screenshot at the moment of failure — capture the broken state, not after recovery
- For visual/layout bugs, also screenshot the baseline (working state) for comparison:
<step-id>-baseline.png
How to verify (in order of rigor)
- Deterministic check (strongest) —
browse evalreturns structured data you can inspect. Examples: axe-core violation count,document.title, form field value, console error array, element count. - Snapshot element match — a specific element with a specific role and text exists in the accessibility tree. Check by ref:
@0-12 button "Save". An element either exists in the tree or it doesn't. - Before/after comparison — snapshot before action, act, snapshot after. Verify the tree changed in the expected way (element appeared, disappeared, text changed).
- Screenshot + visual judgment (weakest) — only for visual-only properties (color, spacing, layout) that the accessibility tree cannot capture. Always accompany with what specifically you're evaluating.
Before/after comparison pattern
This is the core verification loop. Use it for every interaction:
# 1. BEFORE: capture state
browse snapshot
# Record: what elements exist, their text, their refs
# 2. ACT: perform the interaction
browse click @0-12
# 3. AFTER: capture new state
browse snapshot
# Compare: what changed? What appeared? What disappeared?
# 4. ASSERT: emit marker based on comparison
# If dialog appeared: STEP_PASS|modal-open|dialog "Confirm" appeared at @0-20
# If nothing changed:
browse screenshot --path .context/ui-test-screenshots/modal-open.png
# STEP_FAIL|modal-open|expected dialog to appear → snapshot unchanged|.context/ui-test-screenshots/modal-open.png
Setup
which browse || npm install -g browse
Avoid permission fatigue
This skill runs many browse commands (snapshots, clicks, evals). To avoid approving each one, add browse to your allowed commands:
Add both patterns to .claude/settings.json (project-level) or ~/.claude/settings.json (user-level):
{
"permissions": {
"allow": [
"Bash(browse:*)",
"Bash(BROWSE_SESSION=*)"
]
}
}
The first pattern covers plain browse commands. The second covers parallel sessions (BROWSE_SESSION=signup browse open ...). Both are needed to avoid approval prompts.
Mode Selection
| Target | Mode | Command | Auth |
|--------|------|---------|------|
| localhost / 127.0.0.1 | Local | browse open <url> --local | None needed (clean isolated local browser by default) |
| Deployed/staging site | Remote | browse open <url> --remote | Browserbase credentials; use contexts where supported |
Rule: If the target URL contains localhost or 127.0.0.1, pass --local on the first browse open.
Local Mode (default for localhost)
browse open http://localhost:3000 --local
browse open ... --local uses a clean isolated local browser by default, which is best for reproducible localhost QA runs.
Use local-mode variants only when needed:
browse open <url> --auto-connect— auto-discover an existing debuggable local Chrome. Use this only when the test explicitly needs existing local login/cookies/state.browse open <url> --cdp <port|url>— attach to a specific CDP target (explicit local browser attach).
Remote Mode (deployed sites via cookie-sync)
# Step 1: Sync cookies from local Chrome to Browserbase
node .claude/skills/cookie-sync/scripts/cookie-sync.mjs --domains your-app.com
# Output: Context ID: ctx_abc123
# Step 2: Open in remote mode with the synced context
SESSION_JSON="$(browse cloud sessions create --context-id ctx_abc123 --persist --keep-alive)"
SESSION_ID="$(echo "$SESSION_JSON" | jq -r .id)"
CONNECT_URL="$(echo "$SESSION_JSON" | jq -r .connectUrl)"
browse open https://staging.your-app.com --cdp "$CONNECT_URL"
browse snapshot
# ... run tests ...
browse stop
browse cloud sessions update "$SESSION_ID" --status REQUEST_RELEASE
Cookie-sync flags: --domains, --context, --verified, --proxy "City,ST,US"
Workflow A: Diff-Driven Testing
Phase 1: Analyze the diff
git diff --name-only HEAD~1 # or: git diff --name-only / git diff --name-only main...HEAD
git diff HEAD~1 -- <file> # read actual changes
Categorize changed files:
| File pattern | UI impact | What to test | |-------------|-----------|-----------
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
