sentry-browser-sdk

安装量: 192
排名: #4475

安装

npx skills add https://github.com/getsentry/sentry-for-ai --skill sentry-browser-sdk

All Skills

SDK Setup Browser SDK Sentry Browser SDK Opinionated wizard that scans your project and guides you through complete Sentry setup for browser JavaScript — vanilla JS, jQuery, static sites, WordPress, and any JS project without a framework-specific SDK. Invoke This Skill When User asks to "add Sentry to a website" or set up Sentry for plain JavaScript User wants to install @sentry/browser or configure the Loader Script User has a WordPress, Shopify, Squarespace, or static HTML site User wants error monitoring, tracing, session replay, or logging without a framework No framework-specific SDK applies Note: SDK versions and APIs below reflect @sentry/browser ≥10.0.0. Always verify against docs.sentry.io/platforms/javascript/ before implementing. Phase 1: Detect CRITICAL — Check for frameworks first. Framework-specific SDKs provide significantly better coverage and must be recommended before proceeding with @sentry/browser . Step 1A: Framework Detection (Redirect If Found)

Check for React

cat package.json 2

/dev/null | grep -E '"react"'

Check for Next.js

cat package.json 2

/dev/null | grep '"next"'

Check for Vue

cat package.json 2

/dev/null | grep '"vue"'

Check for Angular

cat package.json 2

/dev/null | grep '"@angular/core"'

Check for Svelte / SvelteKit

cat package.json 2

/dev/null | grep -E '"svelte"|"@sveltejs/kit"'

Check for Remix

cat package.json 2

/dev/null | grep -E '"@remix-run/react"|"@remix-run/node"'

Check for Nuxt

cat package.json 2

/dev/null | grep '"nuxt"'

Check for Astro

cat package.json 2

/dev/null | grep '"astro"'

Check for Ember

cat package.json 2

/dev/null | grep '"ember-source"'

Check for Node.js server frameworks (wrong SDK entirely)

cat package.json 2

/dev/null | grep -E '"express"|"fastify"|"@nestjs/core"|"koa"' If a framework is detected, stop and redirect: Framework detected Redirect to next Load sentry-nextjs-sdk skill — do not proceed here react (without Next.js) Load sentry-react-sdk skill — do not proceed here vue Suggest @sentry/vue — see docs.sentry.io/platforms/javascript/guides/vue/ @angular/core Suggest @sentry/angular — see docs.sentry.io/platforms/javascript/guides/angular/ @sveltejs/kit Load sentry-svelte-sdk skill — do not proceed here svelte (SPA, no kit) Suggest @sentry/svelte — see docs.sentry.io/platforms/javascript/guides/svelte/ @remix-run Suggest @sentry/remix — see docs.sentry.io/platforms/javascript/guides/remix/ nuxt Suggest @sentry/nuxt — see docs.sentry.io/platforms/javascript/guides/nuxt/ astro Suggest @sentry/astro — see docs.sentry.io/platforms/javascript/guides/astro/ ember-source Suggest @sentry/ember — see docs.sentry.io/platforms/javascript/guides/ember/ express / fastify / @nestjs/core This is a Node.js server — load sentry-node-sdk or sentry-nestjs-sdk skill Why redirect matters: Framework SDKs add router-aware transactions, error boundaries, component tracking, and often SSR coverage. Using @sentry/browser directly in a React or Next.js app loses all of that. Only continue with @sentry/browser if no framework is detected . Step 1B: Installation Method Detection

Check if there's a package.json at all (bundler environment)

ls package.json 2

/dev/null

Check package manager

ls package-lock.json yarn.lock pnpm-lock.yaml bun.lockb 2

/dev/null

Check build tool

ls vite.config.ts vite.config.js webpack.config.js rollup.config.js esbuild.config.js 2

/dev/null cat package.json 2

/dev/null | grep -E '"vite"|"webpack"|"rollup"|"esbuild"'

Check for CMS or static site indicators

ls wp-config.php wp-content/ 2

/dev/null

WordPress

ls _config.yml _config.yaml 2

/dev/null

Jekyll

ls config.toml 2

/dev/null

Hugo

ls .eleventy.js 2

/dev/null

Eleventy

Check for existing Sentry

cat package.json 2

/dev/null | grep '"@sentry/' grep -r "sentry-cdn.com|js.sentry-cdn.com" . --include = "*.html" -l 2

/dev/null | head -3 What to determine: Question Impact package.json exists + bundler? → Path A: npm install WordPress, Shopify, static HTML, no npm? → Path B: Loader Script Script tags only, no Loader Script access? → Path C: CDN bundle Already has @sentry/browser ? Skip install, go straight to feature config Build tool is Vite / webpack / Rollup / esbuild? Source maps plugin to configure Phase 2: Recommend Present a recommendation based on what you found. Lead with a concrete proposal, don't ask open-ended questions. Recommended (core coverage): ✅ Error Monitoring — always; captures unhandled errors and promise rejections ✅ Tracing — recommended for any interactive site; tracks page load and user interactions ✅ Session Replay — recommended for user-facing apps; records sessions around errors Optional (enhanced observability): ⚡ User Feedback — capture reports directly from users after errors ⚡ Logging — structured logs via Sentry.logger.* ; requires npm or CDN logs bundle (not available via Loader Script) ⚡ Profiling — JS Self-Profiling API; beta, Chromium-only, requires Document-Policy: js-profiling response header Feature recommendation logic: Feature Recommend when... Error Monitoring Always — non-negotiable baseline Tracing Always for interactive pages — page load + navigation spans are high-value Session Replay User-facing app, support flows, or checkout pages User Feedback Support-focused app; want in-app bug reports with screenshots Logging Structured log search or log-to-trace correlation needed; npm path only Profiling Performance-critical, Chromium-only app; Document-Policy: js-profiling header required Installation path recommendation: Scenario Recommended path Project has package.json + bundler Path A (npm) — full features, source maps, tree-shaking WordPress, Shopify, Squarespace, static HTML Path B (Loader Script) — zero build tooling, always up to date Static HTML without Loader Script access Path C (CDN bundle) — manual