browser-trace

77 / 100 · Review before installing

Check before installing. Some of what it can do is expected: a coding skill usually runs build and test commands.

By browserbase/skills (GitHub) · coding · 3,756 stars · scanned at commit 6811ca3

Capture a full DevTools-protocol trace of any browser automation — CDP firehose, screenshots, and DOM dumps — then bisect the stream into per-page searchable buckets. Use when the user wants to debug a failed run, audit network/console/DOM activity, attach a trace to an in-progress session, or feed structured per-page summaries back into an agent loop so its next iteration learns from the last one.

Works with any agent that supports SKILL.md skills.

What this skill can do

Connects to the internet

This is disclosed by the author in the skill's SKILL.md or README.

Found in 1 place.

skills/browser-trace/REFERENCE.md, line 326| `browse cdp exited immediately` | unreachable target / completed Browserbase session | verify port is listening (`curl http://local

Downloads and installs other software

The author does not mention this.

Found in 3 places.

skills/browser-trace/REFERENCE.md, line 327| `error: unknown command 'cdp'` | older browse build lacks the command | `npm install -g browse@latest` (or the alpha
skills/browser-trace/SKILL.md, line 4compatibility: "Requires Node 18+, the browse CLI (`npm install -g browse`) with `browse cdp`, and optionally `jq` for ad-hoc querying of the bisected JSONL fil
skills/browser-trace/SKILL.md, line 28which browse || npm install -g browse

Runs commands on your computer

The author does not mention this. Expected for a coding skill.

Found in 16 places.

skills/browser-trace/SKILL.md, line 27node --version # require Node 18+
skills/browser-trace/SKILL.md, line 35browse --help | grep -q "^\s*cdp " || echo "browse cdp not available — update browse"
skills/browser-trace/SKILL.md, line 54"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \

Show 13 more

skills/browser-trace/SKILL.md, line 78export BROWSERBASE_API_KEY=...
skills/browser-trace/SKILL.md, line 102browse cloud sessions list | jq -r '.[] | select(.status == "RUNNING") | .id'
skills/browser-trace/SKILL.md, line 189node scripts/query.mjs my-run list # one-line table of pages
skills/browser-trace/SKILL.md, line 205jq -c '.params' .o11y/<run>/cdp/network/failed.jsonl
skills/browser-trace/scripts/bb-capture.mjs, line 14import { spawnSync } from 'node:child_process';
skills/browser-trace/scripts/bb-capture.mjs, line 65const start = spawnSync(process.execPath, startArgs, { stdio: ['ignore', 'pipe', 'inherit'] });
skills/browser-trace/scripts/lib.mjs, line 8import { execFileSync } from 'node:child_process';
skills/browser-trace/scripts/lib.mjs, line 75const stdout = execFileSync(cmd, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], ...opts });
skills/browser-trace/scripts/snapshot-loop.mjs, line 11import { spawnSync } from 'node:child_process';
skills/browser-trace/scripts/snapshot-loop.mjs, line 45spawnSync('browse', ['screenshot', '--cdp', target, '--path', png], { stdio: 'ignore' });
skills/browser-trace/scripts/snapshot-loop.mjs, line 52const r = spawnSync('browse', ['get', 'html', 'body', '--cdp', target], { encoding: 'utf8' });
skills/browser-trace/scripts/snapshot-loop.mjs, line 66const u = spawnSync('browse', ['get', 'url', '--cdp', target], { encoding: 'utf8' });
skills/browser-trace/scripts/start-capture.mjs, line 13import { spawn } from 'node:child_process';

Safer alternatives

Low-risk skills in the same category (coding) that look related. Check that one does what you need.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'browser-trace' ] || [ -L ~/.agents/skills/'browser-trace' ]; then echo 'A skill folder named browser-trace already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/browserbase/skills' "$d" && git -C "$d" checkout --quiet '6811ca31163332d9d60309cff48e77f09de37a17' -- 'skills/browser-trace' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/browser-trace' ~/.agents/skills/'browser-trace' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'browser-trace' ~/.claude/skills/'browser-trace' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for browserbase/skills shows the score of its lowest-scoring skill.

SkillTrust badge for browserbase/skills

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/browserbase/skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/browserbase/skills/)

Score history

Date	Version	Score
2026-11-08	`6811ca3`	77
2026-11-06	`6811ca3`	57

Also found in

Identical copies of this skill exist at:

mxyhi/ok-skills/browser-trace