Skip to content
Skillpedia
Agents70k · #1734

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

https://github.com/code-yeongyu/oh-my-openagent/blob/dev/packages/shared-skills/skills/browser/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/code-yeongyu/oh-my-openagent/blob/dev/packages/shared-skills/skills/browser/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
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 browser

Or 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.md
Technical 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

repo: code-yeongyu/oh-my-openagent

Popularity

GitHub stars
70k
Ranking position
#1734
License
NOASSERTION
Updated
10/16/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills