oh-my-design: Skill for Claude Code

ego-browser

For installation, connection, or runtime problems, read references/install.md. Use help() or references/api.md for signatures and uncommon options of APIs named below.

Run browser scripts

Run JavaScript through a heredoc:

ego-browser nodejs <<'EOF'
const task = await taskSpace("inspect example page");
const page = task.page("p1");
await page.goto("https://example.com");

console.log({ taskSpaceId: task.spaceId, page: page.label });
console.log(await page.snapshot());
EOF

In some sandbox environments, heredoc input may not work; use -e instead:

ego-browser nodejs -e '
const task = await taskSpace("inspect example page");
const page = task.page("p1");
await page.goto("https://example.com");
console.log({ taskSpaceId: task.spaceId, page: page.label });
console.log(await page.snapshot());
'

In Bash/Zsh, use single quotes around the code and double quotes for JavaScript strings. Single quotes within the code require shell quoting.

The script always runs in Node.js, not in the web Page. Browser helpers and Node.js APIs belong in the script; Page globals such as window, document, location, and DOM APIs do not. Put browser-side JavaScript inside page.evaluate(). Do not import Playwright or launch another browser.

The Node.js runtime uses ESM. When a script needs local files, load built-ins with dynamic imports such as await import("node:fs/promises").

Ego-browser deliberately exposes a small custom API. It is not Playwright, even where method names and options look similar. Use only the TaskSpace, Page, FileChooser, mouse, and keyboard APIs explicitly listed in this Skill. Do not infer Playwright methods such as locator(), getByRole(), context(), expect(), or route(). When the listed API does not cover an operation, use the documented page.evaluate() or page.cdp() escape hatches instead of guessing another method.

Pointer actions accept an optional label with a concise 3-6 word description. Pass it with clicks, hovers, drags, or scrolling to keep the action text next to the visible agent cursor in sync with the action.