glebis/browser-mate
browser-mate/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add glebis/claude-skills browser-mateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 4, 2026, 2:04 AM139.7s4 files scanned
SKILL.md
- name:
- browser-mate
- description:
- 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.
browser-mate
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.
The one invariant (never violate)
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.
Usage
# 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.
Profiles
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/" }
} }
- Each profile keeps its own login state — log in once per profile, it persists.
- Add a profile by editing the JSON: pick a unique port and a dedicated
user_data_dir(the launcher validates uniqueness and refuses dirs that point at the user's real Chrome profile).
Authentication
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.
Safety & limits
- Loopback only. The debug port binds to
127.0.0.1(Chrome default). CDP has no auth — anyone local can drive it. Use on trusted machines; never pass--remote-debugging-address. - Dedicated data dir. A profile's
user_data_dirmust never be the user's real Chrome profile (~/Library/Application Support/Google/Chrome*) — the launcher refuses these. - Locked dir. If a profile's dir is already open in a non-debug Chrome window, the launcher fails loudly rather than killing it.
- Replaces
real-browser's launch step; interaction still usesagent-browser.
Related Skills
glebis/rigorous-experiments
development
VerifiedTrustedCommunity
This skill should be used when designing, running, validating, or auditing statistical experiments on personal or observational time-series data (health metrics, speech/text corpora, behavioral logs, diaries, n-of-1 self-tracking). It enforces pre-registration, exact permutation tests, FDR discipline, data-validation gates, adversarial code review, and cross-validation with external models. Triggers on "design an experiment", "test this hypothesis on my data", "is this correlation real", "audit these findings", "pre-register", "validate this dataset", or any n-of-1 / quantified-self analysis request.
251SKILL.mdUpdated Jun 7, 2026
glebis/tufte-report
development
VerifiedTrustedCommunity
Create Tufte-inspired data reports and infographic dashboards as standalone HTML files. Uses EB Garamond for text, Monaspace Argon for numbers, Chart.js for interactive charts, and inline SVG sparklines. Produces publication-quality reports with 2-column narrative+data layouts, status dashboards, scroll animations, and responsive mobile support. Use this skill whenever the user wants to create a data report, activity dashboard, infographic, personal analytics page, health tracker visualization, or any document that combines narrative text with interactive charts and tables. Also triggers for "make a report like Tufte", "create an infographic", "build a dashboard", "visualize my data", or requests for beautiful data-driven documents.
246SKILL.mdUpdated Apr 24, 2026
glebis/release
documentation
VerifiedTrustedCommunity
Cut a software release and maintain a tiered compatibility policy. Use when the user wants to release, ship a version, bump the version, tag a release, write a changelog, or update COMPATIBILITY. Config-driven via release.config.json; bumps version files, runs a readiness gate, updates COMPATIBILITY.md tiers and deprecations, tags (→ release workflow), and reports closed issues. Teaches the underlying standards as it runs.
242SKILL.mdUpdated Jun 4, 2026
glebis/library-sync
development
VerifiedTrustedCommunity
Sync and manage bilingual (EN/RU) library content for agency-docs. Use when adding, updating, or reviewing library articles. Handles translation, sync checks, and Russian stylistic review.
242SKILL.mdUpdated Jun 4, 2026