browser-skill

Browser automation instructions for controlling a user’s logged-in Chromium browser through the bsk command-line tool and its extension.

In plain words
What is it for?
Use it to visit pages, collect page data, complete browser-based tasks, or smoke-test a deployed interface.
Why use it?
They provide a defined way to read pages, fill forms, click through workflows, and test web interfaces while protecting normal browser windows and credentials.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tencent/browserskill/skill
Any agent
npx skills add Tencent/BrowserSkill --skill skill
Clone the repo
git clone --depth 1 https://github.com/Tencent/BrowserSkill

Made for: Claude Code, Codex.

Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,151 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00064 $0.05151
Opus 5 $0.00032 $0.02576
Sonnet 5 $0.00013 $0.01030
Haiku 4.5 $0.00006 $0.00515

Measured yesterday against content hash 02c4004a5834, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

browser-skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

crates/bsk-cli/skill/SKILL.md · 328 lines

How it starts

The opening of the file, as written. The whole thing — 328 lines — stays where its author put it; the contents beside it link to each section on GitHub.

browser-skill

Drive the user's real Chromium browser (with their logins and cookies) through the bsk CLI. The extension opens an isolated Agent Window for automation; the user's normal windows stay protected unless you explicitly borrow a tab.

When to use

  • Open pages, read titles/text, scrape structured data from sites the user can already access
  • Fill forms, click through multi-step flows, smoke-test a UI change
  • Understand pages with bsk snapshot first; use bsk get-html or bsk screenshot only when the snapshot is insufficient
  • Operate on a specific user tab they point you at (after bsk tab borrow)

When NOT to use

  • Tasks with no browser involved (files, APIs, databases only)
  • Installing or configuring the extension (point the user to setup docs instead)
  • Credential harvesting — never run bsk evaluate on banking, SSO, or password-manager pages to extract tokens, cookies, or secrets
  • Long-lived control of a user's personal login window — borrow only for the immediate step, then bsk tab return or end the session
  • Replacing the user's manual browsing when they only wanted an explanation

Prerequisites

  1. bsk on PATH (Rust CLI from browser-skill)
  2. browser-skill extension loaded in Chromium and connected (popup shows green)
  3. Any bsk command auto-starts background services as needed; use bsk doctor if anything fails

Mandatory workflow

Every automation task must follow this lifecycle. Do not rely on idle timeouts (default session idle is 5 minutes).

1. bsk session start              → capture the 4-letter session id printed on stdout
2. … every tool command …        → always pass --session <id>
3. bsk session stop <id>          → REQUIRED when done (even on error paths)

Optional: bsk session start --browser <instance-id-or-label> when multiple browsers are connected (bsk browsers / error output lists them). Add --no-focus to open the Agent Window in the background without stealing focus from the user's current window.

Read the full file on GitHub · 328 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 328 lines · 64 tokens per session scan A 02c4004a5834

Subscribe to this mod's changes

browser-skill is a skill published in the GitHub repository Tencent/BrowserSkill (1,541 stars, last pushed 3d ago), licensed MIT. It adds 64 tokens to every session and 5,151 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

obo

Control the user's real Chrome browser with their logged-in sessions, cookies, and extensions. Triggers include "open a website", "click a button", "fill a form", "take a screenshot", "check my email", "browse as me", or any task requiring the user's authenticated browser.

agenthand/obo · 61 tokens

browser-qa

Use this skill to automate visual testing and UI interaction verification using browser automation after deploying features.

gongyijie85/dsh-ecc · 22 tokens

browser-use

Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work.

browser-use/browser-use · 26 tokens

dingtalk_channel_connect

Use a headed browser to automatically complete DingTalk channel integration for QwenPaw. Applicable when the user mentions DingTalk, developer console, Client ID, Client Secret, bot, Stream mode, binding or configuring a channel. Supports pausing when a login page is detected and resuming after the user logs in.

agentscope-ai/QwenPaw · 69 tokens

opencli-autofix

Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through collecting a trace artifact, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.

jackwener/OpenCLI · 61 tokens

browser_cdp

当用户明确希望连接到已运行的 Chrome 浏览器、扫描本地 CDP 端口、显式指定 cdpport,或让多个 agent / 工具共享同一个浏览器时,使用本 skill。browser 默认不开放调试端口;仅当用户明确希望其他本地工具附加时才显式传入 cdpport。.

agentscope-ai/QwenPaw · 85 tokens