browse

Controls a persistent headless Chromium browser for QA testing, page interaction, and screenshot capture.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill browse-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: browse
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/gstack/browse
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill browse-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, playwright-core, diff, bun, and includes scripts (resource) components.

What problem does it solve? Manually verifying that a web feature works, that a deployment looks right, or that a bug is reproducible requires opening a browser, clicking through flows, and capturing evidence. This Skill gives an AI agent a persistent headless Chromium browser so it can navigate pages, interact with elements, and collect proof automatically at roughly 100ms per command. ## Core Features & Use Cases - Page Interaction & Assertions: Navigate URLs, click, fill forms, upload files, handle dialogs, and assert element states (visible, enabled, checked, focused) using accessibility-tree @refs from snapshots. - Visual Evidence & Diffing: Take plain or annotated screenshots, capture responsive layouts at mobile/tablet/desktop viewports, diff snapshots before and after actions, and compare two URLs side by side. - State Persistence & Handoff: Cookies, tabs, and login sessions persist between commands; when blocked by CAPTCHAs or MFA, hand off to a visible Chrome window and resume control afterward. - Use Case: After deploying a login flow, ask the agent to open the staging URL, fill credentials, submit the form, diff the snapshot to confirm the dashboard appeared, check the console for JS errors, and attach an annotated screenshot to the bug report. ## Quick Start Ask the agent to open your app's URL in the browser, test the login flow, and take a screenshot of the result.

Frequently Asked Questions about browse

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test a website with a headless browser from the command line?

Use the browse CLI to navigate with goto, inspect pages with text, console, and network, then interact via click and fill using @e refs from a snapshot. The first call auto-starts a persistent Chromium server, and subsequent commands run in about 100ms.

How do I take annotated screenshots of web page elements?

Run snapshot with the -a and -o flags to produce an annotated screenshot with red overlay boxes and ref labels, or use screenshot with a CSS selector or @ref to crop to a specific element. The responsive command captures mobile, tablet, and desktop viewports in one call.

Does headless browser testing work when a site requires login or MFA?

Yes, cookies and login sessions persist between commands, and cookie-import-browser can import cookies from installed Chromium browsers. For CAPTCHAs or multi-factor auth, the handoff command opens a visible Chrome window so the user can complete the step, then resume returns control.

Why do my element refs stop working after navigation?

Refs like @e3 are invalidated whenever the page navigates because the underlying locators point to stale elements. Run snapshot again after any goto, reload, or navigation to get fresh refs before interacting.

What are the limitations of headless browser automation for QA?

Headless mode cannot solve CAPTCHAs, bot detection, or interactive OAuth and MFA flows on its own; these require the handoff feature for user takeover. The initial server startup takes about 3 seconds, and a one-time build with Bun is required before first use.