dd-browser-sdk — Claude Code skill: what it does, how to install
Routes coding agents through Datadog Browser SDK upgrades from v4 to v7 and automates sourcemap uploads across major bundlers.
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a claude-codeWhat dd-browser-sdk does
This skill acts as an orchestration router for Datadog client-side tools, covering RUM, Logs, and Session Replay. It triggers on file patterns matching @datadog/browser-* or datadog-logs packages. Instead of relying on training memory, it commands the agent to read explicit migration files directly from the skill directory.
The workflow covers four main pathways. Three routing branches handle major version migrations: v4 to v5, v5 to v6, and v6 to v7. It flags removed configuration flags such as proxyUrl, sampleRate, or betaEncodeCookieOptions, while addressing dropped IE11 support and outdated CDN paths. A dedicated sourcemap branch assists with setting up Datadog build plugins in Vite, Webpack, Rollup, Rspack, and esbuild configs to resolve minified Error Tracking stacks.
The router depends strictly on the nested SKILL.md files inside .claude/skills/dd-browser-sdk/. If those sub-skill files are missing during installation, the agent cannot execute the migration steps.
What it helps with
- upgrade Datadog Browser SDK code from v4 through v7
- configure sourcemap uploads for Vite, Webpack, Rollup, Rspack, or esbuild
- identify deprecated Browser SDK options before major version bumps
- unminify stack traces in Datadog Error Tracking and RUM
Example prompts for the agent
- Upgrade our Datadog Browser SDK integration from v5 to v6
- Set up Datadog sourcemap uploads in our Vite config
- Check our datadog-rum setup for removed v7 options
How to install dd-browser-sdk
1Skills CLI (Vercel)
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/dd-browser-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/dd-browser-sdk/
1Skills CLI (Vercel)
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a codex2Manually: put the files in place
.agents/skills/dd-browser-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a cursor2Manually: put the files in place
.cursor/skills/dd-browser-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install datadog-labs/agent-skills dd-browser-sdk2Manually: put the files in place
.github/skills/dd-browser-sdk/SKILL.md1Skills CLI (Vercel)
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a gemini-cli2Platform CLI
gemini skills install https://github.com/datadog-labs/agent-skills --path dd-browser-sdkManually: put the files in place
.devin/skills/dd-browser-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about dd-browser-sdk
How to install dd-browser-sdk in Claude Code?
Run npx skills add datadog-labs/agent-skills --skill dd-browser-sdk -a claude-code in your terminal.
What does dd-browser-sdk do?
It directs agents to step-by-step instructions for upgrading Datadog Browser SDK packages and configuring sourcemaps. It flags removed options, deprecated APIs, and outdated CDN URLs across versions v4 to v7.
Which bundlers are supported for sourcemap uploads?
The skill covers build setups using Vite, Webpack, Rollup, Rspack, and esbuild.
Source text
SKILL.md · MIT
--- name: dd-browser-sdk description: > Datadog Browser SDK — RUM, Logs, Session Replay, profiling, product analytics, and error tracking setup, configuration, and migration. Use when upgrading Browser SDK versions, setting up RUM or Logs, or troubleshooting browser-side Datadog instrumentation. metadata: version: "1.0.0" author: datadog-labs repository: https://github.com/datadog-labs/agent-skills tags: datadog,browser-sdk,rum,logs,session-replay,profiling,product-analytics,error-tracking,sourcemaps,build-plugin,cdn,npm,migration globs: "**/@datadog/browser-*,**/datadog-rum*,**/datadog-logs*" --- # Datadog Browser SDK RUM, Logs, and Session Replay instrumentation for browser applications. ## Skills | Task | Skill | |------|-------| | Upgrade from v4 to v5 | `dd-browser-sdk/upgrade-v5` | | Upgrade from v5 to v6 | `dd-browser-sdk/upgrade-v6` | | Upgrade from v6 to v7 | `dd-browser-sdk/upgrade-v7` | | Set up sourcemap upload via the build plugin | `dd-browser-sdk/setup-sourcemaps` | ## Routing **Upgrading from v4 to v5** (removed options like `proxyUrl`, `sampleRate`, `replaySampleRate`, `premiumSampleRate`, `allowedTracingOrigins`, deprecated APIs like `addRumGlobalContext`, `removeUser`, or `/v4/` CDN paths): **Immediately read** `.claude/skills/dd-browser-sdk/upgrade-v5/SKILL.md` — do not proceed from memory. **Upgrading from v5 to v6** (removed options like `useCrossSiteSessionCookie`, `sendLogsAfterSessionExpiration`, dropping IE11 support, or `/v5/` CDN paths): **Immediately read** `.claude/skills/dd-browser-sdk/upgrade-v6/SKILL.md` — do not proceed from memory. **Upgrading from v6 to v7** (removed options like `betaEncodeCookieOptions`, `allowFallbackToLocalStorage`, `trackBfcacheViews`, `usePciIntake`, or `/v6/` CDN paths): **Immediately read** `.claude/skills/dd-browser-sdk/upgrade-v7/SKILL.md` — do not proceed from memory. **Setting up sourcemap upload** (minified stack traces in RUM or Error Tracking, requests to "upload sourcemaps" or "unminify errors", or a project with a vite/webpack/rollup/rspack/esbuild config and no `@datadog/*-plugin` configured): **Immediately read** `.claude/skills/dd-browser-sdk/setup-sourcemaps/SKILL.md` — do not proceed from memory.
© datadog-labs · MIT · datadog-labs/agent-skills
