code-yeongyu/oh-my-openagent / packages/shared-skills/skills/browser
browser
VerifiedDrives a real browser through the omowright library from the js eval kernel: sites the user is already signed into, forms and clicks, JS-rendered pages, screenshots, web QA, extension popups, a human handoff for login, CAPTCHA or OTP, and a browser you own for scraping, bot-scored targets, network capture and QA traces. Use for any interactive browser task; not for a plain search or an unblocked static fetch.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 303 B |
| .npmignore | other | 160 B |
| ATTRIBUTION.md | markdown | 2.1 KB |
| SKILL.md | skill md | 10.3 KB |
| references/commands.md | markdown | 8.6 KB |
| references/install.md | markdown | 5.7 KB |
| references/owned-engine/README.md | markdown | 3.2 KB |
| references/owned-engine/frames-and-humans.md | markdown | 3.1 KB |
| references/owned-engine/ladder.md | markdown | 3.8 KB |
| references/owned-engine/network.md | markdown | 2.9 KB |
| references/recipes/1password.md | markdown | 2.8 KB |
| references/remote.md | markdown | 1.1 KB |
| scripts/browser-doctor-report.mjs | script | 5.5 KB |
| scripts/browser-doctor.mjsexecutable | script | 1.9 KB |
| scripts/browser-engine-guard.mjs | script | 3.5 KB |
| scripts/browser-install.mjsexecutable | script | 3.0 KB |
| scripts/omowright.mjs | script | 2.1 KB |
references/owned-engine/README.md
View on GitHub# The owned engine
A browser **your code launches and owns**, driven over CDP by omowright with its own profile. The
opposite of the attached engine: no user logins, full control.
```js
const { omowright } = await loadOmowright()
const profile = mkdtempSync(join(tmpdir(), "omowright-"))
const browser = await omowright.connectPipe({
browserPath: "<CloakBrowser or chrome-headless-shell binary>",
browserArgs: ["--headless", "--no-first-run", `--user-data-dir=${profile}`],
storageRoot: profile,
dialogPolicy: { accept: true },
})
try {
const page = await browser.newTab("https://example.com/")
const tree = omowright.compactSnapshot(await page.snapshot()) // ALWAYS compact before a model reads it
await page.locator("e3").click() // refs come straight from the snapshot
await Bun.write("shot.png", await page.screenshot())
} finally {
await browser.close()
rmSync(profile, { recursive: true, force: true }) // paired: a leftover profile is a logged-in browser nobody watches
}
```
`connectPipe` launches over `--remote-debugging-pipe`: no listening port, stdio drained, the
process reaped on `close()`. `connect("http://127.0.0.1:<port>")` attaches to a browser something
else launched. `connectCloakProfile({ profileDir })` launches CloakBrowser with a pinned
fingerprint seed — the stealth path for WAF and bot-scored targets, where the attached engine's
console capture would be a signal.
## When it is the right engine
| Reason | Why the attached engine cannot |
|---|---|
| A throwaway or pinned synthetic profile | the attached engine is the user's real profile |
| Bot-scoring or fingerprint evasion | you do not get to configure the user's browser |
| Solving a challenge widget programmatically | needs coordinate control and OCR |
| Reading the network instead of the DOM | needs request interception on your own target |
| A QA flight trace (steps, HAR, screenshots) | recording someone's real session is not acceptable |
| Headless or unattended runs | the user's browser is on their desk |
For anything that needs the user's login, the attached engine wins. For extracting text from a
blocked URL, neither: use the `ultimate-browsing` skill.
## The page
`OmOPage` is Playwright-shaped: `goto`, `snapshot`, `locator(ref | css)`, `click`, `fill`,
`press`, `hover`, `check`, `selectOption`, `dragTo`, `setInputFiles`, `screenshot`, `pdf`,
`evaluate`, `waitForURL`, `keyboard`, `mouse`, `frameLocator`. A snapshot is an accessibility tree
with virtual refs (`[ref=e3]`, cross-origin frames as `f1e3`); `compactSnapshot()` drops the refs
map, about half the bytes. Readiness is a content probe (body plus interactive elements, landmarks
or text), not a timer; `goto(url, { waitUntil: "commit" })` is the escape hatch for empty pages.
## Reference
- [ladder.md](ladder.md) — the escalation ladder, viewport pinning, `createCua`, `createCaptcha`
- [network.md](network.md) — `createNetworkSnoop`, `collectWhileScrolling`, `createTrace`, `createRoutes`
- [frames-and-humans.md](frames-and-humans.md) — `snapshotWithFrames`, `describeLayers`, dialog policy, `emulate`, `requestHuman`
The omowright repository's own agent guide and its `presets/*`
is the authoritative, longer treatment of each; these pages are the routing summary.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |