- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add glebis/claude-skills --skill browser-mate -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add glebis/claude-skills --skill browser-mate -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add glebis/claude-skills --skill browser-mate -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add glebis/claude-skills --skill browser-mate -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/glebis/claude-skills/tree/HEAD/browser-mateFrom the publisher
Non-destructive Chrome automation. The problem it solves: to attach a CDP/agent-browser
session, Chrome must run with --remote-debugging-port. The real-browser skill achieves
this by quitting Chrome Beta first, destroying the user's open tabs. browser-mate
instead runs a dedicated debug Chrome instance (its own --user-data-dir + port) that
coexists with the user's main browser — Chrome permits concurrent instances when the
data dirs differ, so no quit is needed.
Never quit, pkill, or osascript quit any browser. The skill only ever launches a
new dedicated instance or reuses an existing one. The single stop path sends SIGTERM only
to a process matched by BOTH our dedicated user_data_dir AND our debug port — never the
user's browser.
# Ensure a profile's debug Chrome is up (launch or reuse); prints the PORT on stdout
PORT=$(python3 scripts/browser.py chatgpt)
# Then drive it with agent-browser (always pass --cdp $PORT). See references/agent-browser.md
SID=$(LC_ALL=C tr -dc 'a-z0-9' < /dev/urandom | head -c 6)
agent-browser --cdp $PORT --session $SID open "https://chatgpt.com/"
agent-browser --cdp $PORT --session $SID snapshot -i
Other subcommands:
python3 scripts/browser.py list # configured profiles
python3 scripts/browser.py status [profile] # up/down
python3 scripts/browser.py stop chatgpt # SIGTERM OUR instance only (graceful)
For the full agent-browser command set (click, fill, upload, screenshot, reliability,
upgrade gotchas), read references/agent-browser.md.
Config: ~/.config/browser-mate/profiles.json (auto-created from assets/profiles.example.json
on first run). Each profile:
{ "default": "automation",
"profiles": {
"automation": { "binary": "<chrome binary>", "user_data_dir": "~/.browser-mate/automation", "port": 9222 },
"chatgpt": { "binary": "<chrome binary>", "user_data_dir": "~/.browser-mate/chatgpt", "port": 9223, "default_url": "https://chatgpt.com/" }
} }
user_data_dir
(the launcher validates uniqueness and refuses dirs that point at the user's real Chrome
profile).Cannot enter passwords (and must not). For a first-time login, launch the profile, then ask
the user to log in manually in that window once; the session persists in the profile's
user_data_dir for all future runs.
127.0.0.1 (Chrome default). CDP has no auth
— anyone local can drive it. Use on trusted machines; never pass --remote-debugging-address.user_data_dir must never be the user's real Chrome
profile (~/Library/Application Support/Google/Chrome*) — the launcher refuses these.real-browser's launch step; interaction still uses agent-browser.Use when automating a real, logged-in Chrome WITHOUT disturbing the user's open tabs — e.g. authenticated sessions like ChatGPT, LinkedIn, or any site needing a persistent login. Launches or reuses a
---name: browser-matedescription: Use when automating a real, logged-in Chrome WITHOUT disturbing the user's open tabs — e.g. authenticated…---# browser-mate/SKILL.mdOverview
Use when automating a real, logged-in Chrome WITHOUT disturbing the user's open tabs — e.g. authenticated sessions like ChatGPT, LinkedIn, or any site needing a persistent login. Launches or reuses a dedicated debug Chrome instance per named profile that coexists with the user's main browser; it never quits or kills any browser (unlike real-browser, which closes Chrome Beta's tabs). Trigger on "automate this site without closing my tabs", "use my logged-in session", "open ChatGPT/LinkedIn in automation", or when a browser task must preserve the user's existing windows. macOS, requires the agent-browser CLI.
FAQ
Download browser-mate/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/glebis/claude-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.