Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .claude/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .agents/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .cursor/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .gemini/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .github/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "browser" agent skill from https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/extension/.pi/skills/browser into .opencode/skills/browser/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
browser
GitHub stars
315
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
839 words
Files
19 (incl. scripts, references)
Skills in repo
66
Repo updated
First seen
Licence
Apache-2.0
At a glance
Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.
Works in 2 steps: references/dashboard-relay.md when the… → references/own-browser.md (legacy…
The user needs to drive websites
SKILL.md covers Step 0a — Preflight:…, Step 0b — Auto-detect: route…, Step 1 — Read the matched… and Notes
Runs Shell scripts from its folder; calls npm, curl and npx
What it does
Browser is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Browser automation via the agent-browser CLI. Use when the user needs to drive websites or Electron apps — navigating, forms, clicks, screenshots, data extraction, testing web apps, UI checks, the dashboard Electron shell, or the user's own logged-in Chrome via the browser relay or Panerelay (SSO/2FA). Triggers: "open a website", "take a screenshot", "test this web app", "use my own browser".
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and reference files (for example `SKILL.md.AGENTS.md`, `UPSTREAM.md` and `references/challenge.md`).
It sits in Productivity & Automation, covering Browser automation and Authentication. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is Apache-2.0.
2 steps, taken from the first numbered list in SKILL.md.
1references/dashboard-relay.md when the pi session runs on the
2references/own-browser.md (legacy Panerelay bridge) only when the
What it can do on your machine
Read from SKILL.md and the folder at commit e23e533. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Bash(agent-browser:*)
Bash(npx agent-browser:*)
Bash(npx @panerelay/setup:*)
Bash(curl:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
npm
curl
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, curl and npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Browser loads about 2k tokens when it runs, and up to ~40k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 839 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~101
When it runs· the whole SKILL.md, loaded when a task matches
~2k
With references· SKILL.md plus every file in references/, read only if the agent opens them
~40k
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
Download SKILL.mdSave it as .claude/skills/browser/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
browser
description
Browser automation via the `agent-browser` CLI. Use when the user needs to drive websites or Electron apps — navigating, forms, clicks, screenshots, data extraction, testing web apps, UI checks, the dashboard Electron shell, or the user's own logged-in Chrome via the browser relay or Panerelay (SSO/2FA). Triggers: "open a website", "take a screenshot", "test this web app", "use my own browser".
Composite skill that gives the agent eyes and hands for any browser-driven
task — web pages or Electron desktop apps — via the agent-browser CLI.
Three recipes:
Web automation — generic web pages plus Pi Dashboard-specific helpers
(dashboard URL detection, responsive testing, console-error hunting).
Reference: references/web.md.
Electron automation — drive any Chromium-based Electron app, including
a worked example for the Pi Dashboard's own shell via --debug-cdp.
Reference: references/electron.md.
The user's own logged-in browser — reach SSO/2FA-gated sites using the
user's real cookies. Two paths:
Pi Dashboard browser relay (preferred when the pi session runs on the
dashboard host) — pair the Playwright Chrome Extension, connect to a
loopback CDP URL. Reference:
references/dashboard-relay.md.
Panerelay extension bridge (legacy) — a native-messaging host for when
there is no loopback dashboard. Reference:
references/own-browser.md.
Step 0a — Preflight: agent-browser CLI must be installed
The skill does not bundle the CLI. Verify it through the dashboard tool
registry — recommend-only, nothing installs without an explicit --install:
<extension-package-root> is the package that ships this skill — three levels
above this SKILL.md's .pi/skills/browser/ directory (in a global install:
$(npm root -g)/@blackbelt-technology/pi-dashboard/node_modules/@blackbelt-technology/pi-dashboard-extension).
The manifest (pi.tools) declares agent-browser (resolve) and chromium
(pw-browser); the registry answers present / recommended / blocked per
tool.
agent-browser: present → continue to Step 0b.
agent-browser: recommended or blocked → halt and tell the user:
The agent-browser CLI is not installed. Install it as a pi extension so
the browser tool is registered in your pi session too:
pi install npm:pi-agent-browser
Then re-invoke the skill.
chromium missing → mention the registry's Install hint
(npx playwright@1.62.1 install chromium) only when the chosen recipe needs a
CDP browser; the dropdown on the Settings → Tools row carries it.
Do not attempt npm install, pi install, or any other install command
on the user's behalf — they should make that choice explicitly.
Step 0b — Auto-detect: route to the right recipe
After the preflight, decide which recipe applies. Run this 2-line probe:
Pi Dashboard is up but CDP off — electron.md shows the --debug-cdp launch instruction
any
no
references/web.md
No Electron target running; default to web
Override: if the user's request is explicitly about a website (URL,
HTTPS host, "the dashboard at localhost:8000", etc.), route to
references/web.md regardless of what's running. Intent wins over capability.
Override: if the user's request is explicitly about an Electron app
that isn't Pi Dashboard (Slack, VS Code, Figma, …), route to
references/electron.md even when PD_RUNNING=no — that recipe covers
launching any Electron app with --remote-debugging-port.
Override (login state): if the target needs the user's existing
session — "use my browser", "I'm already logged in", SSO/2FA, an internal
tool the agent cannot sign into — route to a login-state recipe regardless of
the probe. Pick by capability, in this order:
references/dashboard-relay.md when the pi session runs on the
dashboard host and the probe's RELAY is a JSON object with
"enabled":true and "canOpenChrome":true. This is the preferred path;
it needs no extra install and the dashboard holds the pairing token.
references/own-browser.md (legacy Panerelay bridge) only when the
relay is unavailable (RELAY=unavailable) or the session is remote.
The default bundled browser starts logged out and cannot be made to inherit
those logins; --profile copies the profile and still loses macOS
Keychain-encrypted cookies. Prefer the bundled browser whenever login state is
irrelevant — it is faster and more capable. Never fall back to it for a
login-state task.
Show full SKILL.md (280 more words)Show less
Step 1 — Read the matched recipe and execute
Read the reference file selected above, then follow its workflow. All
references are self-contained; you do not need to read more than one.
Challenge encountered: if at any point the page is an interactive
anti-bot challenge (Cloudflare Turnstile, hCaptcha, reCAPTCHA, "Checking
your browser…") that withholds the content you asked for, stop and follow
references/challenge.md. Do not retry, do not
switch --session, --profile, or provider, and do not run close --all.
Notes
Vendoring: references/web.md and references/electron.md are
snapshots of upstream agent-browser skill content (core and
electron) at CLI version 0.27.0. See UPSTREAM.md for
refresh procedure and LICENSE for upstream attribution.
references/own-browser.md, references/dashboard-relay.md, and
references/challenge.md are authored, not vendored — an upstream
refresh must not overwrite them.
Login-state recipes: references/dashboard-relay.md is the preferred
path (Pi Dashboard browser relay); references/own-browser.md is the legacy
Panerelay/native-messaging path for remote sessions with no loopback
dashboard.
Surfaces share one browser: the browser MCP tool and
Bash: agent-browser … drive the same daemon and same Chrome, with a
shared active page. Probing with one mid-task can silently move the page
out from under the other. Pick one surface per task; use
--session <name> for genuinely isolated browsers.
Known wrapper bug: the MCP tool's eval echoes the JS source instead
of executing it (and mangles regex escapes) — still present with CLI
0.33.2, so it is a pi-agent-browser wrapper defect, not a CLI one. Use
Bash: agent-browser eval … instead.
No CLI bundled: agents installing the bridge extension get the
skill text but not the CLI; install on demand per Step 0a.
User-local override: if the user's project has its own
.pi/skills/browser/ skill, pi's local-wins precedence applies and
this skill is shadowed — that's by design.
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in BlackBeltTechnology/pi-agent-dashboard, which our catalogue first saw on October 7, 2026.
Browser next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
Browser compared with similar skills
Skill
Stars
Used in
Tokens
Auto-check
Licence
Repo updated
Browser this skillBlackBeltTechnology/pi-agent-dashboard
Publish Markdown articles to Zhihu Columns through authentication context recovered locally from Bifrost traffic and a built-in publish payload schema, save drafts, prevent duplicate posts, and…
A skill your agent uses when an agent must inspect or operate an authenticated SAP web UI through an in-app Browser, Microsoft Edge CDP, or an existing Playwright client, especially when SAP SSO…
Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…
Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.
Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…
Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard. Browser is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Browser automation via the agent-browser CLI.
When should I use Browser?
Browser fits situations like: the user needs to drive websites; electron apps — navigating; data extraction; testing web apps.
How do I install Browser in Claude Code?
Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a claude-code`. Or copy the skill folder (packages/extension/.pi/skills/browser in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/browser in your project. Claude Code loads it when a task matches its description.
How do I install Browser in Codex?
Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a codex`. Or copy the skill folder (packages/extension/.pi/skills/browser in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/browser in your project. Codex loads it when a task matches its description.
Can I use Browser in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill browser -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/browser, .gemini/skills/browser, .github/skills/browser and .opencode/skills/browser in your project.
What does Browser need to run?
Going by SKILL.md and its folder, Browser needs a shell for the scripts in its folder and the command-line tools its instructions call (npm, curl and npx). Our summary lists: Node.js; A Bash shell. Its frontmatter pre-approves these tools: Bash(agent-browser:*), Bash(npx agent-browser:*), Bash(npx @panerelay/setup:*), Bash(curl:*).
Does Browser access the network?
SKILL.md contains no URLs. Its commands use npm, curl and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Browser safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Browser use?
Browser is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Browser use?
About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 38k tokens, read only when the agent opens those files.
What are the alternatives to Browser?
Skills that share tags, products or a category with Browser: Zhihu Publish (bifrost-proxy/bifrost, 160 stars), Agent Browser (HHU3637kr/skills, 145 stars), Bitwarden Browser Aac Login (aiskillstore/marketplace, 430 stars) and Sap Browser Automation (secondsky/sap-skills, 462 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Browser?
BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.