setup-browser-sdk-sourcemaps
Ce skill fait partie du repository public datadog-labs/agent-skills, qui regroupe des skills Datadog prêts à l'emploi pour les agents IA (Claude Code, Cursor, Gemini CLI, etc.). Il est rattaché au groupe dd-browser-sdk, dédié au Browser SDK Datadog (RUM, Logs, Session Replay, Error Tracking).
Ce que fait ce skill
Il guide un agent IA à travers la configuration complète de l'upload de sourcemaps JavaScript lors du build d'un projet frontend. L'objectif concret : faire en sorte que les stack traces affichées dans Datadog RUM et Error Tracking soient lisibles (non minifiées), avec des liens directs vers le code source via les métadonnées git.
Le skill couvre cinq bundlers : esbuild, Rollup, Rspack, Vite et webpack, via les packages @datadog/esbuild-plugin, @datadog/rollup-plugin, @datadog/rspack-plugin, @datadog/vite-plugin et @datadog/webpack-plugin. Il exclut explicitement Next.js et Turbopack, qui nécessitent une approche différente (datadog-ci sourcemaps upload en script postbuild).
Structure en 7 étapes
Le skill impose un processus séquentiel en 7 étapes que l'agent doit suivre dans l'ordre : détection du bundler, collecte de trois valeurs obligatoires (service, releaseVersion, minifiedPathPrefix), installation du plugin, activation de l'émission de sourcemaps côté bundler, câblage du plugin dans la config, configuration des credentials dans l'environnement de build, puis vérification. Des règles strictes encadrent chaque étape : l'agent ne doit jamais inventer une valeur, doit s'arrêter et interroger l'utilisateur si une information est introuvable dans le repo, et ne doit jamais écrire la clé API dans un fichier versionné.
Quand utiliser ce skill
Il est pertinent dès qu'un projet dispose d'un bundler supporté et de @datadog/browser-rum déjà initialisé, mais sans upload de sourcemaps configuré — typiquement quand les erreurs dans Datadog affichent du code minifié. Il ne remplace pas le skill dd-instrument-rum : le RUM doit être instrumenté au préalable.