Fast Playwright

This skill provides a persistent, headless browser environment optimized for LLM agents. It keeps the browser open between calls to enable fast interactions.

Setup

Run the installation script once to set up dependencies and download browsers:

node scripts/install.js

Usage

All tools are executed via client.js. Arguments must be valid JSON.

node scripts/client.js <tool_name> '<json_args>'

Options

Multi-Agent Session Isolation

Each session gets its own isolated browser context (cookies, storage, page state):

# Agent A uses session "agent-a"
node scripts/client.js --session agent-a browser_navigate '{"url": "https://site-a.com"}'

# Agent B uses session "agent-b" (completely isolated)
node scripts/client.js --session agent-b browser_navigate '{"url": "https://site-b.com"}'

# List active sessions
node scripts/client.js --sessions

# Without --session, uses shared "default" session
node scripts/client.js browser_navigate '{"url": "https://example.com"}'

Sessions auto-expire after 15 minutes of inactivity.

Headed Mode (Visible Browser)

Add --headed to see the browser window:

node scripts/client.js --headed browser_navigate '{"url": "https://example.com"}'

Note: The server must be restarted to switch between headed/headless modes:

node scripts/client.js --stop

Token Optimization

Most tools accept an expectation object to control output size:

{
  "expectation": {
    "includeSnapshot": false,
    "diffOptions": { "enabled": true }
  }
}

Tools Reference

Navigation

browser_navigate

Navigate to a URL.

node scripts/client.js browser_navigate '{"url": "https://example.com"}'

browsernavigateback

Go back to previous page.

node scripts/client.js browser_navigate_back '{}'

browsernavigateforward

Go forward to next page.

node scripts/client.js browser_navigate_forward '{}'

Interaction

browser_click

Click an element. Supports CSS, text, role selectors.

node scripts/client.js browser_click '{"selectors": [{"css": "button.submit"}]}'

browser_type

Type text into an element.

node scripts/client.js browser_type '{"selectors": [{"css": "#search"}], "text": "query"}'

browserpresskey

Press a keyboard key.

node scripts/client.js browser_press_key '{"key": "Enter"}'

browser_hover

Hover over an element.

node scripts/client.js browser_hover '{"selectors": [{"css": ".menu-item"}]}'

browser_drag

Drag and drop between elements.

node scripts/client.js browser_drag '{"startSelectors": [{"css": "#source"}], "endSelectors": [{"css": "#target"}]}'

browserselectoption

Select option in dropdown.

node scripts/client.js browser_select_option '{"selectors": [{"css": "select#country"}], "values": ["US"]}'

browserfileupload

Upload files to file input.

node scripts/client.js browser_file_upload '{"paths": ["/path/to/file.pdf"]}'

browserhandledialog

Handle alert/confirm/prompt dialogs.

node scripts/client.js browser_handle_dialog '{"accept": true}'

Page State

browser_snapshot

Get accessibility snapshot of current page.

node scripts/client.js browser_snapshot '{}'

browsertakescreenshot

Take a screenshot.

node scripts/client.js browser_take_screenshot '{"filename": "page.png"}'

browser_evaluate

Evaluate JavaScript on page.

node scripts/client.js browser_evaluate '{"function": "() => document.title"}'

browserconsolemessages

Get console messages.

node scripts/client.js browser_console_messages '{}'

browsernetworkrequests

Get network requests.

node scripts/client.js browser_network_requests '{}'

Element Discovery

browserfindelements

Find elements by text, role, tag, or attributes.

node scripts/client.js browser_find_elements '{"searchCriteria": {"text": "Submit"}}'

browserinspecthtml

Extract and analyze HTML content.

node scripts/client.js browser_inspect_html '{"selectors": [{"css": "main"}]}'

Tab Management

browsertablist

List all open tabs.

node scripts/client.js browser_tab_list '{}'

browsertabnew

Open a new tab.

node scripts/client.js browser_tab_new '{"url": "https://example.com"}'

browsertabselect

Select a tab by index.

node scripts/client.js browser_tab_select '{"index": 0}'

browsertabclose

Close a tab.

node scripts/client.js browser_tab_close '{}'

Browser Control

browser_resize

Resize browser window.

node scripts/client.js browser_resize '{"width": 1920, "height": 1080}'

browser_close

Close the browser.

node scripts/client.js browser_close '{}'

browser_install

Install the configured browser.

node scripts/client.js browser_install '{}'

Utilities

browserwaitfor

Wait for text to appear/disappear or time to pass.

node scripts/client.js browser_wait_for '{"text": "Loading complete"}'
node scripts/client.js browser_wait_for '{"textGone": "Loading..."}'
node scripts/client.js browser_wait_for '{"time": 2}'

browser_diagnose

Analyze page complexity and performance.

node scripts/client.js browser_diagnose '{}'

Batch Execution

browserbatchexecute

Execute multiple steps in sequence. Highly recommended for forms.

node scripts/client.js browser_batch_execute '{
  "steps": [
    {"tool": "browser_type", "arguments": {"selectors": [{"css": "#user"}], "text": "me"}},
    {"tool": "browser_type", "arguments": {"selectors": [{"css": "#pass"}], "text": "123"}},
    {"tool": "browser_click", "arguments": {"selectors": [{"css": "#login"}]}}
  ]
}'

Selector Types

All interaction tools support multiple selector strategies:

• CSS: {"css": "#id"}, {"css": ".class"}, {"css": "button[type=submit]"}
• Role: {"role": "button"}, {"role": "textbox", "text": "Search"}
• Text: {"text": "Click me"}
• Ref: {"ref": "e3"} (from previous snapshot)

Multiple selectors act as fallbacks:

{"selectors": [{"css": "#submit"}, {"role": "button", "text": "Submit"}]}