browsing · git:20261118.549ccf7 · 2026-11-18 · sha256 f77bbcf1a02166d7

browsing git:20261118.549ccf7A

Immutable. This exact content never changes and is served at /api/v1/blob/f77bbcf1a02166d7.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_qv7g6zocgkuzzbij/f77bbcf1a02166d74fdedbf1fed236821315043e87e39eb60dc20654a08bbbdb.json

Then /plugin install browsing@markdownregistry-qv7g6zocgkuzzbij in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: browsing
description: Automates browser workflows, live UI verification, and end-to-end user journeys using Antigravity browser tools and Playwright. Use when testing web applications, verifying UI layout or responsiveness, or reproducing browser errors.
---

# Browsing & Web Automation

Execute reliable browser automation, live UI verification, and end-to-end user journeys using Antigravity's `/browser` subagent, Chrome DevTools MCP, or Playwright test harnesses.

## Decision tree

1. **Does the task require a real browser engine?**
   - **No (static docs search, REST/GraphQL API tests, or local code inspection)** → Use `search_web`, `curl` or integration tests via `run_command`, or `read_file` / `rg -n`. **Do not launch a browser.**
   - **Yes (live UI rendering, CSS layout, SPA interactions, responsive checks, screenshots/video proof)** → Proceed to step 2.
2. **Is the target a local dev server (`localhost` / `127.0.0.1`)?**
   - **Yes** → Verify the server port is live before navigating (or start/ask the user).
   - **No** → Verify domain allowlist policies (see [references/antigravity-subagent.md](./references/antigravity-subagent.md)).
3. **Which modality fits?**
   - **Interactive inspection / visual layout proof** → Use `/browser` or `invoke_subagent`.
   - **Automated regression script** → Run [scripts/run-browser.mjs](./scripts/run-browser.mjs) or adapt [examples/e2e-journey-example.mjs](./examples/e2e-journey-example.mjs) via `run_command`.

## Workflow & rules

1. **Pre-Flight**: Confirm target URL responds and define pass/fail checks (URL, visible role/text, zero `console.error`, zero 4xx/5xx responses).
2. **Resilient Locators**: Follow [references/locators-and-patterns.md](./references/locators-and-patterns.md): `getByRole` > `getByLabel` > `getByPlaceholder` > `getByText` > `getByTestId`. Ban CSS positional selectors (`div > div:nth-child(2)`) and arbitrary sleeps (`waitForTimeout`).
3. **CLI Helper**:
   ```bash
   node .agents/skills/browsing/scripts/run-browser.mjs http://localhost:3000 .scratch/ui-proof.png
   ```
4. **Verify & Clean Up**: Confirm exit code `0`, verify screenshot artifact exists, and ensure headless browser processes exit cleanly. Preserve user-specified years/versions in any search queries.