browser
Allows your agent to interact with websites like a real user. Useful for filling forms, clicking buttons, handling dynamic pages, and performing interactive tasks.
What it does
This tool lets the AI interact with a real web browser. It can visit websites, fill out forms, click buttons, and even take screenshots, as if a person were using the browser.
When to use it
- ✓When you need the AI to fill out an online form.
- ✓For the AI to click buttons or links on a website.
- ✓If you need the AI to take a picture (screenshot) of a web page.
Example of what to ask your AI
“Take a screenshot of my bank's homepage and fill in my CPF in the indicated field.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The AI uses a special tool to control your browser. It can see what's on the screen, click where you tell it to, and even ask for your confirmation for important actions like purchases.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add code-yeongyu/oh-my-openagent --skill browserOr download just the file:
curl -L https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/packages/shared-skills/skills/browser/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Browser
One library, two engines. omowright ships inside this skill; choose the engine before you act:
| You need | Engine | Entry point |
|---|---|---|
| A site the user is signed into, their open tabs, a form, a click-through, a screenshot, web QA, an extension popup | attached — the user's own browser through BrowserSkill | connectBrowserSkill() |
| A throwaway profile, bot-scoring evasion, a CAPTCHA, network interception, a QA flight trace, coordinate control, headless runs | owned — a browser your code launches | connectPipe() / connectCloakProfile() — references/owned-engine/README.md |
| A 403/WAF host the attached engine cannot open, a platform with a native reader, an archive snapshot | neither | the ultimate-browsing skill |
Attached is the default, because it is the only engine carrying the user's logins and the only one where a human is a single call away. Never substitute one engine for the other silently: if the attached engine is not set up, run the onboarding script and tell the user its one remaining step.
Step 0 — which engine this session is allowed to use
When OMO_BROWSER_ENGINE is set (the OmO desktop app sets it for every session), it wins over the table above:
| Value | What you do |
|---|---|
connected |
Use connectBrowserSkill() only. If the user's browser is not connected you get a "Connect your browser" error: relay it and stop. Never open another browser |
builtin |
Do not call connectBrowserSkill(); use the app's in-app browser tools |
none |
Do not do browser work. Say that agent browser access is off for this project |
| unset | The table above, as before (terminal use) |
While any engine is set, loadOmowright() returns a guarded library. The owned engine (connectPipe,
connectCloakProfile, connect) and every other export that acts on a browser is refused, so the table above
does not apply: do not look for a way around it, and tell the user what the session allows. Under connected
the app sees what the browser is doing, and before a click, Enter or script that sends, posts, pays, orders,
subscribes, deletes or closes an account, and before Enter in a message box, it asks the user first. A "No" fails the action with
BrowserActionDeclinedError: report that, never retry it or go around it (session.tool() lets only reads
through; evaluate is guarded too). If the user presses Stop, the next call throws BrowserUserStoppedError: tell
the user browser use was stopped and start no new session this turn.
The guard prevents mistakes by a cooperating agent. It is not a security boundary: code that imports the raw
entry (resolveOmowrightEntry()) is not guarded, and a host without the omo_browser_bridge tool cannot show state or
honor Stop, though questions are still asked.
Step 1 — load omowright and prove the stack
const { loadOmowright } = await import("<skill-root>/scripts/omowright.mjs")
const { omowright } = await loadOmowright() // { connectBrowserSkill, bskSnapshot, connectPipe, ... }
node "<skill-root>/scripts/browser-doctor.mjs" --json
| State | Meaning | Next |
|---|---|---|
ready |
CLI, daemon and a connected browser | start a session |
no-cli / no-daemon / no-extension |
something is missing | node "<skill-root>/scripts/browser-install.mjs" [--browser=<id>] prepares everything it can for the browser the user uses, then prints the single step only the user can do (relaunch that browser and click Enable); relay it verbatim, wait, re-run the doctor |
choose-browser |
the signals do not single out one browser (Safari/Firefox default, an idle default while another browser runs, several in use) | nothing was installed; take the browser from memory or ask the user, then browser-install.mjs --browser=<id> |
no-browser-support |
no Chromium-family profile on this machine | say so and stop |
Install into the browser the user actually uses, never into whatever happens to be on disk. Before
installing, check your memory for the user's browser; otherwise read the doctor's browser (picked
from the OS default browser, running apps and recent use — candidates shows the evidence). If memory
and the doctor disagree, or the doctor says choose-browser, ask the user. Pass the answer as
--browser=<id> and record it in memory. A Chrome that is merely installed is not their browser.
…
FAQ
What happens if the website asks for a login and password?
If you are already logged into your browser, the AI can use that connection. For new logins or those requiring extra confirmation (like a code), the AI might ask for your help.
Can the AI do anything in my browser?
The AI is guided by your instructions. It won't perform actions like purchases or account deletions without asking for your confirmation first. It also cannot perform simple searches, only interact with websites.
Do I need to install anything?
You might. If it's the first time, the AI may guide you to install an extension in your browser so it can control it.
Details
Original description by the author
Drives 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 s
Popularity
- GitHub stars
- 70k
- Ranking position
- #1734
- License
- NOASSERTION
- Updated
- 10/16/2026
Comments
- …
More skills from this repository
comment-checker
Helps your agent understand and respond to feedback from automatic comment checkers. It's useful when the agent needs to process information from tools that automatically review code or content.
code-yeongyu/oh-my-openagent
lcx-contribute-bug-fix
Helps your agent contribute bug fixes for LazyCodex-related projects. It creates issues or pull requests to ensure code quality.
code-yeongyu/oh-my-openagent
lcx-doctor
Lets your agent check the health of LazyCodex and Codex CLI installations. It's useful when the system behaves oddly after updates or changes.
code-yeongyu/oh-my-openagent
lcx-report-bug
Helps your agent report bugs in detail for LazyCodex projects. It creates issues with useful information for developers to fix the problem.
code-yeongyu/oh-my-openagent
Similar skills
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC