Claude Cursor opencode Skill

dev-browser

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scra

LLM Mart · 0 points · 14 views 0 listing impressions 0 install-command copies
Download code-yeongyu-oh-my-openagent-packages_skills-loader-core_src_features_builtin-skills_dev-browser-05dcba6.zip · 7 KB
This skill couldn't be refreshed from GitHub on the last check — you're seeing the last imported snapshot.

Install

skills CLI npx skills add https://github.com/code-yeongyu/oh-my-openagent/tree/dev/packages/skills-loader-core/src/features/builtin-skills/dev-browser
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install code-yeongyu-oh-my-openagent@llmmart
Git git clone https://github.com/code-yeongyu/oh-my-openagent.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole code-yeongyu/oh-my-openagent collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Dev Browser Skill

Browser automation that maintains page state across script executions. Write small, focused scripts to accomplish tasks incrementally. Once you've proven out part of a workflow and there is repeated work to be done, you can write a script to do the repeated work in a single execution.

Choosing Your Approach

  • Local/source-available sites: Read the source code first to write selectors directly
  • Unknown page layouts: Use getAISnapshot() to discover elements and selectSnapshotRef() to interact with them
  • Visual feedback: Take screenshots to see what the user sees

Setup

Installation: See references/installation.md for detailed setup instructions including Windows support.

Two modes available. Ask the user if unclear which to use.

Standalone Mode (Default)

Launches a new Chromium browser for fresh automation sessions.

./skills/dev-browser/server.sh &

Add --headless flag if user requests it. Wait for the Ready message before running scripts.

Extension Mode

Connects to user's existing Chrome browser. Use this when:

  • The user is already logged into sites and wants you to do things behind an authed experience that isn't local dev.
  • The user asks you to use the extension

Important: The core flow is still the same. You create named pages inside of their browser.

Start the relay server:

cd skills/dev-browser && npm i && npm run start-extension &

Wait for Waiting for extension to connect... followed by Extension connected in the console. To know that a client has connected and the browser is ready to be controlled. Workflow:

  1. Scripts call client.page("name") just like the normal mode to create new pages / connect to existing ones.
  2. Automation runs on the user's actual browser session

If the extension hasn't connected yet, tell the user to launch and activate it. Download link: https://github.com/SawyerHood/dev-browser/releases

Writing Scripts

Run all scripts from skills/dev-browser/ directory. The @/ import alias requires this directory's config.

Execute scripts inline using heredocs:

cd skills/dev-browser && npx tsx <<'EOF'
import { connect, waitForPageLoad } from "@/client.js";

const client = await connect();
// Create page with custom viewport size (optional)
const page = await client.page("example", { viewport: { width: 1920, height: 1080 } });

await page.goto("https://example.com");
await waitForPageLoad(page);

console.log({ title: await page.title(), url: page.url() });
await client.disconnect();
EOF

Write to tmp/ files only when the script needs reuse, is complex, or user explicitly requests it.

Key Principles

  1. Small scripts: Each script does ONE thing (navigate, click, fill, check)
  2. Evaluate state: Log/return state at the end to decide next steps
  3. Descriptive page names: Use "checkout", "login", not "main"
  4. Disconnect to exit: await client.disconnect() - pages persist on server
  5. Plain JS in evaluate: page.evaluate() runs in browser - no TypeScript syntax

Workflow Loop

Follow this pattern for complex tasks:

  1. Write a script to perform one action
  2. Run it and observe the output
  3. Evaluate - did it work? What's the current state?
  4. Decide - is the task complete or do we need another script?
  5. Repeat until task is done

No TypeScript in Browser Context

Code passed to page.evaluate() runs in the browser, which doesn't understand TypeScript:

// ✅ Correct: plain JavaScript
const text = await page.evaluate(() => {
  return document.body.innerText;
});

// ❌ Wrong: TypeScript syntax will fail at runtime
const text = await page.evaluate(() => {
  const el: HTMLElement = document.body; // Type annotation breaks in browser!
  return el.innerText;
});

Scraping Data

For scraping large datasets, intercept and replay network requests rather than scrolling the DOM. See references/scraping.md for the complete guide covering request capture, schema discovery, and paginated API replay.

Client API

const client = await connect();

// Get or create named page (viewport only applies to new pages)
const page = await client.page("name");
const pageWithSize = await client.page("name", { viewport: { width: 1920, height: 1080 } });

const pages = await client.list(); // List all page names
await client.close("name"); // Close a page
await client.disconnect(); // Disconnect (pages persist)

// ARIA Snapshot methods
const snapshot = await client.getAISnapshot("name"); // Get accessibility tree
const element = await client.selectSnapshotRef("name", "e5"); // Get element by ref

The page object is a standard Playwright Page.

Waiting

import { waitForPageLoad } from "@/client.js";

await waitForPageLoad(page); // After navigation
await page.waitForSelector(".results"); // For specific elements
await page.waitForURL("**/success"); // For specific URL

Inspecting Page State

Screenshots

await page.screenshot({ path: "tmp/screenshot.png" });
await page.screenshot({ path: "tmp/full.png", fullPage: true });

ARIA Snapshot (Element Discovery)

Use getAISnapshot() to discover page elements. Returns YAML-formatted accessibility tree:

- banner:
  - link "Hacker News" [ref=e1]
  - navigation:
    - link "new" [ref=e2]
- main:
  - list:
    - listitem:
      - link "Article Title" [ref=e8]
      - link "328 comments" [ref=e9]
- contentinfo:
  - textbox [ref=e10]
    - /placeholder: "Search"

Interpreting refs:

  • [ref=eN] - Element reference for interaction (visible, clickable elements only)
  • [checked], [disabled], [expanded] - Element states
  • [level=N] - Heading level
  • /url:, /placeholder: - Element properties

Interacting with refs:

const snapshot = await client.getAISnapshot("hackernews");
console.log(snapshot); // Find the ref you need

const element = await client.selectSnapshotRef("hackernews", "e2");
await element.click();

Error Recovery

Page state persists after failures. Debug with:

cd skills/dev-browser && npx tsx <<'EOF'
import { connect } from "@/client.js";

const client = await connect();
const page = await client.page("hackernews");

await page.screenshot({ path: "tmp/debug.png" });
console.log({
  url: page.url(),
  title: await page.title(),
  bodyText: await page.textContent("body").then((t) => t?.slice(0, 200)),
});

await client.disconnect();
EOF
Files (oh-my-openagent)
  • references
    • installation.md 4.7 KB
      Loading…
    • scraping.md 5.2 KB
      Loading…
  • SKILL.md 6.9 KB
    ---
    name: dev-browser
    description: Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.
    ---
    
    # Dev Browser Skill
    
    Browser automation that maintains page state across script executions. Write small, focused scripts to accomplish tasks incrementally. Once you've proven out part of a workflow and there is repeated work to be done, you can write a script to do the repeated work in a single execution.
    
    ## Choosing Your Approach
    
    - **Local/source-available sites**: Read the source code first to write selectors directly
    - **Unknown page layouts**: Use `getAISnapshot()` to discover elements and `selectSnapshotRef()` to interact with them
    - **Visual feedback**: Take screenshots to see what the user sees
    
    ## Setup
    
    > **Installation**: See [references/installation.md](references/installation.md) for detailed setup instructions including Windows support.
    
    Two modes available. Ask the user if unclear which to use.
    
    ### Standalone Mode (Default)
    
    Launches a new Chromium browser for fresh automation sessions.
    
    ```bash
    ./skills/dev-browser/server.sh &
    ```
    
    Add `--headless` flag if user requests it. **Wait for the `Ready` message before running scripts.**
    
    ### Extension Mode
    
    Connects to user's existing Chrome browser. Use this when:
    
    - The user is already logged into sites and wants you to do things behind an authed experience that isn't local dev.
    - The user asks you to use the extension
    
    **Important**: The core flow is still the same. You create named pages inside of their browser.
    
    **Start the relay server:**
    
    ```bash
    cd skills/dev-browser && npm i && npm run start-extension &
    ```
    
    Wait for `Waiting for extension to connect...` followed by `Extension connected` in the console. To know that a client has connected and the browser is ready to be controlled.
    **Workflow:**
    
    1. Scripts call `client.page("name")` just like the normal mode to create new pages / connect to existing ones.
    2. Automation runs on the user's actual browser session
    
    If the extension hasn't connected yet, tell the user to launch and activate it. Download link: https://github.com/SawyerHood/dev-browser/releases
    
    ## Writing Scripts
    
    > **Run all scripts from `skills/dev-browser/` directory.** The `@/` import alias requires this directory's config.
    
    Execute scripts inline using heredocs:
    
    ```bash
    cd skills/dev-browser && npx tsx <<'EOF'
    import { connect, waitForPageLoad } from "@/client.js";
    
    const client = await connect();
    // Create page with custom viewport size (optional)
    const page = await client.page("example", { viewport: { width: 1920, height: 1080 } });
    
    await page.goto("https://example.com");
    await waitForPageLoad(page);
    
    console.log({ title: await page.title(), url: page.url() });
    await client.disconnect();
    EOF
    ```
    
    **Write to `tmp/` files only when** the script needs reuse, is complex, or user explicitly requests it.
    
    ### Key Principles
    
    1. **Small scripts**: Each script does ONE thing (navigate, click, fill, check)
    2. **Evaluate state**: Log/return state at the end to decide next steps
    3. **Descriptive page names**: Use `"checkout"`, `"login"`, not `"main"`
    4. **Disconnect to exit**: `await client.disconnect()` - pages persist on server
    5. **Plain JS in evaluate**: `page.evaluate()` runs in browser - no TypeScript syntax
    
    ## Workflow Loop
    
    Follow this pattern for complex tasks:
    
    1. **Write a script** to perform one action
    2. **Run it** and observe the output
    3. **Evaluate** - did it work? What's the current state?
    4. **Decide** - is the task complete or do we need another script?
    5. **Repeat** until task is done
    
    ### No TypeScript in Browser Context
    
    Code passed to `page.evaluate()` runs in the browser, which doesn't understand TypeScript:
    
    ```typescript
    // ✅ Correct: plain JavaScript
    const text = await page.evaluate(() => {
      return document.body.innerText;
    });
    
    // ❌ Wrong: TypeScript syntax will fail at runtime
    const text = await page.evaluate(() => {
      const el: HTMLElement = document.body; // Type annotation breaks in browser!
      return el.innerText;
    });
    ```
    
    ## Scraping Data
    
    For scraping large datasets, intercept and replay network requests rather than scrolling the DOM. See [references/scraping.md](references/scraping.md) for the complete guide covering request capture, schema discovery, and paginated API replay.
    
    ## Client API
    
    ```typescript
    const client = await connect();
    
    // Get or create named page (viewport only applies to new pages)
    const page = await client.page("name");
    const pageWithSize = await client.page("name", { viewport: { width: 1920, height: 1080 } });
    
    const pages = await client.list(); // List all page names
    await client.close("name"); // Close a page
    await client.disconnect(); // Disconnect (pages persist)
    
    // ARIA Snapshot methods
    const snapshot = await client.getAISnapshot("name"); // Get accessibility tree
    const element = await client.selectSnapshotRef("name", "e5"); // Get element by ref
    ```
    
    The `page` object is a standard Playwright Page.
    
    ## Waiting
    
    ```typescript
    import { waitForPageLoad } from "@/client.js";
    
    await waitForPageLoad(page); // After navigation
    await page.waitForSelector(".results"); // For specific elements
    await page.waitForURL("**/success"); // For specific URL
    ```
    
    ## Inspecting Page State
    
    ### Screenshots
    
    ```typescript
    await page.screenshot({ path: "tmp/screenshot.png" });
    await page.screenshot({ path: "tmp/full.png", fullPage: true });
    ```
    
    ### ARIA Snapshot (Element Discovery)
    
    Use `getAISnapshot()` to discover page elements. Returns YAML-formatted accessibility tree:
    
    ```yaml
    - banner:
      - link "Hacker News" [ref=e1]
      - navigation:
        - link "new" [ref=e2]
    - main:
      - list:
        - listitem:
          - link "Article Title" [ref=e8]
          - link "328 comments" [ref=e9]
    - contentinfo:
      - textbox [ref=e10]
        - /placeholder: "Search"
    ```
    
    **Interpreting refs:**
    
    - `[ref=eN]` - Element reference for interaction (visible, clickable elements only)
    - `[checked]`, `[disabled]`, `[expanded]` - Element states
    - `[level=N]` - Heading level
    - `/url:`, `/placeholder:` - Element properties
    
    **Interacting with refs:**
    
    ```typescript
    const snapshot = await client.getAISnapshot("hackernews");
    console.log(snapshot); // Find the ref you need
    
    const element = await client.selectSnapshotRef("hackernews", "e2");
    await element.click();
    ```
    
    ## Error Recovery
    
    Page state persists after failures. Debug with:
    
    ```bash
    cd skills/dev-browser && npx tsx <<'EOF'
    import { connect } from "@/client.js";
    
    const client = await connect();
    const page = await client.page("hackernews");
    
    await page.screenshot({ path: "tmp/debug.png" });
    console.log({
      url: page.url(),
      title: await page.title(),
      bodyText: await page.textContent("body").then((t) => t?.slice(0, 200)),
    });
    
    await client.disconnect();
    EOF
    ```
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.