Agent skill

Bb Browser

by Peiiii in Peiiii/nextclaw

A skill your agent uses when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation.

MITAuto-check passedProductivity & Automation

Install Bb Browser

skills CLI
$ npx skills add Peiiii/nextclaw --skill bb-browser -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Peiiii/nextclaw bb-browser --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bb-browser .claude/skills/bb-browser && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bb-browser
GitHub stars
260
Token cost
~1.8k tokens
SKILL.md length
849 words
Files
3
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation.

  • Works in 6 steps: Classify the task → Verify the CLI exists → Choose the execution path → …
  • The user wants browser-backed web data access
  • SKILL.md covers Overview, What This Skill Covers, What This Skill Does Not Cover and Install Boundary, plus 5 more sections
  • Calls npm

What it does

Bb Browser is an agent skill from Peiiii/nextclaw. Use when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `marketplace.json`).

It sits in Productivity & Automation, covering Browser automation. The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

When your agent uses it

  • The user wants browser-backed web data access
  • Authenticated fetches
  • Website adapters
  • Safe browser automation through a local bb-browser installation

Example prompts

  • “/bb-browser”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Classify the task
  2. Verify the CLI exists
  3. Choose the execution path
  4. Run a readiness check
  5. Run one read-only smoke before risky work
  6. Execute the smallest matching command

What it can do on your machine

Read from SKILL.md and the folder at commit 973722e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Bb Browser loads about 1.8k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 849 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Peiiii/nextclaw at commit 973722e, republished under its MIT licence (© Peiiii). 849 words, ~1,805 tokens.

Download SKILL.mdSave it as .claude/skills/bb-browser/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
bb-browser
description
Use when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation.

bb-browser

Overview

Use this skill when the user wants to use the web through their real browser session inside NextClaw.

This marketplace skill wraps the upstream epiral/bb-browser project for NextClaw users.

Be explicit about the boundary:

  • This skill owns explanation, installation guidance, readiness checks, workflow selection, and risk disclosure.
  • The local bb-browser CLI owns actual browser execution.
  • The user's browser login state owns access to private pages and authenticated requests.

Do not pretend the environment is ready when it is not.

What This Skill Covers

  • site adapters such as twitter/search, reddit/thread, github/repo, zhihu/hot, youtube/transcript,
  • authenticated browser-backed fetch,
  • browser automation flows such as open, snapshot, click, fill, eval, network requests, and screenshot,
  • local daemon mode with the user's real Chrome state,
  • optional --openclaw path when the user already wants to run through OpenClaw's browser,
  • first-use setup and bounded troubleshooting.

What This Skill Does Not Cover

  • inventing site adapters or flags that bb-browser does not expose,
  • pretending a site command is safe when it can write, post, delete, purchase, or change account state,
  • hiding missing prerequisites such as the local CLI, running browser, daemon connectivity, or login state,
  • presenting third-party browser execution as native built-in NextClaw capability,
  • silently creating or publishing new adapters to the upstream ecosystem.

Install Boundary

Always distinguish these paths:

  • NextClaw marketplace skill install: nextclaw skills install bb-browser
  • Upstream runtime install: npm install -g bb-browser
  • Optional MCP wiring outside NextClaw: configure bb-browser --mcp in the target MCP client

Installing the marketplace skill does not install the upstream runtime automatically.

Deterministic First-Use Workflow

When the user asks for a bb-browser task, follow this order.

1. Classify the task

Choose exactly one:

  • site read,
  • browser read,
  • browser write or account-affecting action,
  • adapter authoring or reverse-engineering help.

Prefer the smallest workflow that fits the request.

2. Verify the CLI exists

Run:

bash
command -v bb-browser
bb-browser --version

If missing, explain that the local runtime is not installed yet.

Recommended install:

bash
npm install -g bb-browser

Do not continue to the real task until bb-browser exists.

3. Choose the execution path

Use exactly one of these:

  • Default daemon path Use the user's local Chrome session.
  • OpenClaw path Only when the user explicitly wants OpenClaw or already has that browser path ready. Every site command must include --openclaw.

Do not mix the two paths in one command.

4. Run a readiness check

For the default daemon path, ask the user to keep Chrome running, then run:

bash
bb-browser status --json

If it reports running: false or no daemon state, try:

bash
bb-browser daemon

Then re-run:

bash
bb-browser status --json

Success means the daemon is running and Chrome is connected.

For the OpenClaw path, first verify bb-browser exists, then use a lightweight read such as:

bash
bb-browser site list --openclaw

If that works, proceed with the real site task.

5. Run one read-only smoke before risky work

Prefer a read-only command first.

Examples:

bash
bb-browser site list
bb-browser site info reddit/thread
bb-browser site recommend
bb-browser get title
bb-browser eval "document.title"

If adapter coverage is the goal, refresh the community adapter list first:

bash
bb-browser site update

Do not jump straight into write actions if a small read can verify readiness first.

6. Execute the smallest matching command

Examples:

bash
bb-browser site reddit/hot
bb-browser site github/repo owner/repo
bb-browser site youtube/transcript VIDEO_ID
bb-browser fetch https://example.com/api/me --json
bb-browser open https://example.com
bb-browser snapshot -i
bb-browser click @3
bb-browser fill @5 "hello"
bb-browser network requests --with-body

If using OpenClaw for site commands:

bash
bb-browser site reddit/hot --openclaw
bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePercent}'
Show full SKILL.md (358 more words)Show less

Safe Execution Rules

  • Prefer site adapters over manual browser clicking when both can solve the task clearly.
  • Prefer read-only commands before writes.
  • Treat posting, deleting, following, liking, submitting forms, changing settings, purchases, and account mutations as write actions that need explicit confirmation unless the user already gave a clear scoped instruction.
  • If the request only needs information extraction, prefer site, fetch, get, or eval before click or fill.
  • If using snapshot refs, remember that refs are temporary and must be refreshed after navigation or page changes.
  • Close tabs that you opened for the task when they are no longer needed.

Troubleshooting

bb-browser not found
  • Explain that the upstream CLI is not installed locally.
  • Guide installation with npm install -g bb-browser.
  • Re-check with command -v bb-browser.
Daemon not running or Chrome not connected
  • Ask the user to keep Chrome open.
  • Run bb-browser status --json.
  • If needed, start the daemon with bb-browser daemon and check status again.
  • If startup still fails, be explicit that the local browser bridge is not ready yet.
Site command fails or returns unauthorized data
  • Explain that the most likely cause is missing or expired login state in the browser.
  • Ask the user to log into the target site in Chrome or OpenClaw browser, then retry.
Adapter missing or outdated
  • Use:
bash
bb-browser site list
bb-browser site search <keyword>
bb-browser site info <name>
bb-browser site update
  • Do not claim support for an adapter you have not confirmed.
Ref stopped working
  • Explain that @ref values expire after navigation or DOM changes.
  • Re-run:
bash
bb-browser snapshot -i
The user wants a brand new website adapter
  • Be explicit that this is upstream adapter-authoring work, not guaranteed built-in support.
  • Use bb-browser guide to inspect the upstream guide before proposing implementation steps.
  • Do not claim the adapter already exists unless site list or site search proves it.

Success Criteria

This skill is working correctly when:

  • the user understands that execution is performed by the local bb-browser runtime,
  • missing CLI, daemon, browser, or login prerequisites are identified before task execution,
  • a read-only smoke succeeds before heavier workflows when appropriate,
  • write actions stay behind explicit confirmation when required,
  • and the final task runs only after the environment is truly ready.

Attribution

This skill adapts the upstream epiral/bb-browser project for the NextClaw marketplace.

© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/bb-browser of Peiiii/nextclaw.

  • SKILL.md
  • UPSTREAM_LICENSE
  • marketplace.json

Open the folder on GitHubat commit 973722e

Compare with similar skills

Bb 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.

Bb Browser compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bb Browser this skillPeiiii/nextclaw260—~1.8kAutomated safety check: PassMIT
Agent Browserquran/quran.com-frontend-next1.9k42 repos~3.3kAutomated safety check: PassNone
Dev-Browser CLI AutomationSawyerHood/dev-browser6.7k1 repos~455Automated safety check: PassMIT
Agent Browsersuperagent-ai/grok-cli3.5k1 repos~633Automated safety check: PassMIT
Browser Automationopenclaw/openclaw392k—~2.9kAutomated safety check: PassMIT
Camoufox CLIBin-Huang/camoufox-cli3501 repos~4.5kAutomated safety check: PassMIT

Similar skills

  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 42 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Dev-Browser CLI Automation

    SawyerHood/dev-browser

    Browser automation with persistent named pages via the dev-browser CLI. Use when users ask to navigate websites, fill forms, take screenshots, extract web…

    6.7k GitHub starsUsed in 1 repo~455 tokens
    Productivity & AutomationAuto-check passed
  • Agent Browser

    superagent-ai/grok-cli

    Use the host-side agent-browser CLI for local browser smoke tests, screenshots, snapshots, and simple UI validation against forwarded localhost URLs.

    3.5k GitHub starsUsed in 1 repo~633 tokens
    Productivity & AutomationAuto-check passed
  • Browser Automation

    openclaw/openclaw

    A skill your agent uses when controlling web pages with the OpenClaw browser tool, especially multi-step flows, login checks, tab management, or recovery from stale refs/timeouts.

    392k GitHub stars~2.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Camoufox CLI

    Bin-Huang/camoufox-cli

    Anti-detect browser automation CLI & Skills for AI agents. An agent skill from Bin-Huang/camoufox-cli.

    350 GitHub starsUsed in 1 repo~4.5k tokens
    Productivity & AutomationAuto-check passed
  • Browser

    VibiumDev/vibium

    Automate browsers with the Vibium CLI. An agent skill from VibiumDev/vibium.

    2.9k GitHub stars~4.8k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Questions about Bb Browser

What does Bb Browser do?

A skill your agent uses when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation. Bb Browser is an agent skill from Peiiii/nextclaw. Use when the user wants browser-backed web data access, authenticated fetches, website adapters, or safe browser automation through a local bb-browser installation.

When should I use Bb Browser?

Bb Browser fits situations like: the user wants browser-backed web data access; authenticated fetches; website adapters; safe browser automation through a local bb-browser installation.

How do I install Bb Browser in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill bb-browser -a claude-code`. Or copy the skill folder (skills/bb-browser in Peiiii/nextclaw) into .claude/skills/bb-browser in your project. Claude Code loads it when a task matches its description.

How do I install Bb Browser in Codex?

Run `npx skills add Peiiii/nextclaw --skill bb-browser -a codex`. Or copy the skill folder (skills/bb-browser in Peiiii/nextclaw) into .agents/skills/bb-browser in your project. Codex loads it when a task matches its description.

Can I use Bb 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 Peiiii/nextclaw --skill bb-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/bb-browser, .gemini/skills/bb-browser, .github/skills/bb-browser and .opencode/skills/bb-browser in your project.

What does Bb Browser need to run?

Going by SKILL.md and its folder, Bb Browser needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Bb Browser access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bb 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. Review the folder before installing.

What licence does Bb Browser use?

Bb Browser is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bb Browser use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bb Browser?

Skills that share tags, products or a category with Bb Browser: Agent Browser (quran/quran.com-frontend-next, 1.9k stars), Dev-Browser CLI Automation (SawyerHood/dev-browser, 6.7k stars), Agent Browser (superagent-ai/grok-cli, 3.5k stars) and Browser Automation (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bb Browser?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 7, 2026.

Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.