Skip to main content
affpapa.org
RU EN
skill CX Codex

sentry-sdk-setup — Claude Code skill: pick the right Sentry SDK

Reads your project files, picks the matching Sentry SDK skill, and walks through error monitoring, tracing and session replay.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add getsentry/sentry-for-ai --skill sentry-sdk-setup -a claude-code
Open on GitHub

What sentry-sdk-setup does

This skill is a router. It inspects project files such as package.json, go.mod, requirements.txt, Gemfile, *.csproj and build.gradle, then loads the Sentry SDK skill that fits. Each SDK skill carries its own detection logic, prerequisites and step-by-step configuration.

The flow is deliberate. Detect the platform, tell you what was found and which SDK is recommended, then wait for confirmation before reading the skill. When several SDKs could match, the more specific one wins: @nestjs/core routes to sentry-nestjs-sdk rather than sentry-node-sdk, wrangler.toml to sentry-cloudflare-sdk, Next.js to sentry-nextjs-sdk. Plain browser JavaScript lands on sentry-browser-sdk.

You need a DSN for the project. Grab it from the Sentry project settings under Client Keys (DSN). The DSN is public and fine to keep in source code, since it only says where events go. If nothing matches your stack, the skill points you at the Sentry platform docs.

What it helps with

  • add Sentry to a project in a stack the agent does not know
  • choose between SDKs when a repo mixes frameworks
  • locate the project DSN and wire it into config
  • set up error capture, tracing and session replay step by step
  • confirm the SDK choice before any package gets installed

Example prompts for the agent

  • add Sentry to this project
  • set up error monitoring for our stack
  • install the Sentry SDK and tell me which one fits

How to install sentry-sdk-setup

1Skills CLI (Vercel)

npx skills add getsentry/sentry-for-ai --skill sentry-sdk-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/sentry-sdk-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sentry-sdk-setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sentry-sdk-setup

How do I install sentry-sdk-setup in Claude?

Run npx skills add getsentry/sentry-for-ai --skill sentry-sdk-setup -a claude-code. The skill lands at ~/.claude/skills/sentry-sdk-setup/SKILL.md.

What does sentry-sdk-setup do?

It detects your platform from files like package.json or go.mod and loads the matching Sentry SDK skill. It installs nothing until you confirm the recommendation.

Do I need an API key?

You need the project DSN from Sentry. Copy it from the project settings page under Client Keys (DSN). The DSN is not a secret and is safe to commit.

Source text

SKILL.md · Apache-2.0 
---
name: sentry-sdk-setup
description: Set up Sentry in any language or framework. Detects the user's platform and loads the right SDK skill. Use when asked to add Sentry, install an SDK, or set up error monitoring in a project.
license: Apache-2.0
role: router
---

> [All Skills](../../SKILL_TREE.md)

# Sentry SDK Setup

Set up Sentry error monitoring, tracing, and session replay in any language or framework. This page helps you find the right SDK skill for your project.

## Start Here — Read This Before Doing Anything

**Do not skip this section.** Do not assume which SDK the user needs based on their project files. Do not start installing packages or creating config files until you have confirmed the user's intent.

1. **Detect the platform** from project files (`package.json`, `go.mod`, `requirements.txt`, `Gemfile`, `*.csproj`, `build.gradle`, etc.).
2. **Tell the user what you found** and which SDK you recommend.
3. **Wait for confirmation** before reading the skill and proceeding.

Each SDK skill contains its own detection logic, prerequisites, and step-by-step configuration. Trust the skill — read it carefully and follow it. Do not improvise or take shortcuts.

---

## SDK Skills

| Platform | Skill |
|---|---|
| Android | [`sentry-android-sdk`](../sentry-android-sdk/SKILL.md) |
| browser JavaScript | [`sentry-browser-sdk`](../sentry-browser-sdk/SKILL.md) |
| Cloudflare Workers and Pages | [`sentry-cloudflare-sdk`](../sentry-cloudflare-sdk/SKILL.md) |
| Apple platforms (iOS, macOS, tvOS, watchOS, visionOS) | [`sentry-cocoa-sdk`](../sentry-cocoa-sdk/SKILL.md) |
| .NET | [`sentry-dotnet-sdk`](../sentry-dotnet-sdk/SKILL.md) |
| Elixir | [`sentry-elixir-sdk`](../sentry-elixir-sdk/SKILL.md) |
| Go | [`sentry-go-sdk`](../sentry-go-sdk/SKILL.md) |
| NestJS | [`sentry-nestjs-sdk`](../sentry-nestjs-sdk/SKILL.md) |
| Next.js | [`sentry-nextjs-sdk`](../sentry-nextjs-sdk/SKILL.md) |
| Node.js, Bun, and Deno | [`sentry-node-sdk`](../sentry-node-sdk/SKILL.md) |
| PHP | [`sentry-php-sdk`](../sentry-php-sdk/SKILL.md) |
| Python | [`sentry-python-sdk`](../sentry-python-sdk/SKILL.md) |
| Flutter and Dart | [`sentry-flutter-sdk`](../sentry-flutter-sdk/SKILL.md) |
| React Native and Expo | [`sentry-react-native-sdk`](../sentry-react-native-sdk/SKILL.md) |
| React | [`sentry-react-sdk`](../sentry-react-sdk/SKILL.md) |
| React Router Framework | [`sentry-react-router-framework-sdk`](../sentry-react-router-framework-sdk/SKILL.md) |
| TanStack Start React | [`sentry-tanstack-start-sdk`](../sentry-tanstack-start-sdk/SKILL.md) |
| Ruby | [`sentry-ruby-sdk`](../sentry-ruby-sdk/SKILL.md) |
| Svelte and SvelteKit | [`sentry-svelte-sdk`](../sentry-svelte-sdk/SKILL.md) |

### Platform Detection Priority

When multiple SDKs could match, prefer the more specific one:

- **Android** (`build.gradle` with android plugin) → `sentry-android-sdk`
- **Cloudflare** (`wrangler.toml` or `wrangler.jsonc`) → `sentry-cloudflare-sdk` over `sentry-node-sdk`
- **NestJS** (`@nestjs/core`) → `sentry-nestjs-sdk` over `sentry-node-sdk`
- **Next.js** → `sentry-nextjs-sdk` over `sentry-react-sdk` or `sentry-node-sdk`
- **React Router Framework** (`@sentry/react-router` or `@react-router/*`) → `sentry-react-router-framework-sdk` over `sentry-react-sdk`
- **TanStack Start React** (`@tanstack/react-start`) → `sentry-tanstack-start-sdk` over `sentry-react-sdk`
- **Flutter** (`pubspec.yaml` with `flutter:` dependency or `sentry_flutter`) → `sentry-flutter-sdk`
- **React Native** → `sentry-react-native-sdk` over `sentry-react-sdk`
- **PHP** with Laravel or Symfony → `sentry-php-sdk`
- **Elixir** (`mix.exs` detected) → `sentry-elixir-sdk`
- **Node.js / Bun / Deno** without a specific framework → `sentry-node-sdk`
- **Browser JS** (vanilla, jQuery, static sites) → `sentry-browser-sdk`
- **No match** → direct user to [Sentry Docs](https://docs.sentry.io/platforms/)

## Quick Lookup

Match your project to a skill by keywords.

| Keywords | Skill |
|---|---|
| android, kotlin, java, jetpack compose | [`sentry-android-sdk`](../sentry-android-sdk/SKILL.md) |
| browser, vanilla js, javascript, jquery, cdn, wordpress, static site | [`sentry-browser-sdk`](../sentry-browser-sdk/SKILL.md) |
| cloudflare, cloudflare workers, cloudflare pages, wrangler, durable objects, d1 | [`sentry-cloudflare-sdk`](../sentry-cloudflare-sdk/SKILL.md) |
| ios, macos, swift, cocoa, tvos, watchos, visionos, swiftui, uikit | [`sentry-cocoa-sdk`](../sentry-cocoa-sdk/SKILL.md) |
| .net, csharp, c#, asp.net, maui, wpf, winforms, blazor, azure functions | [`sentry-dotnet-sdk`](../sentry-dotnet-sdk/SKILL.md) |
| go, golang, gin, echo, fiber | [`sentry-go-sdk`](../sentry-go-sdk/SKILL.md) |
| elixir, phoenix, plug, oban | [`sentry-elixir-sdk`](../sentry-elixir-sdk/SKILL.md) |
| nestjs, nest | [`sentry-nestjs-sdk`](../sentry-nestjs-sdk/SKILL.md) |
| nextjs, next.js, next | [`sentry-nextjs-sdk`](../sentry-nextjs-sdk/SKILL.md) |
| node, nodejs, node.js, bun, deno, express, fastify, koa, hapi | [`sentry-node-sdk`](../sentry-node-sdk/SKILL.md) |
| php, laravel, symfony | [`sentry-php-sdk`](../sentry-php-sdk/SKILL.md) |
| python, django, flask, fastapi, celery, starlette | [`sentry-python-sdk`](../sentry-python-sdk/SKILL.md) |
| flutter, dart, pubspec | [`sentry-flutter-sdk`](../sentry-flutter-sdk/SKILL.md) |
| react native, expo | [`sentry-react-native-sdk`](../sentry-react-native-sdk/SKILL.md) |
| react, react router, tanstack, redux, vite | [`sentry-react-sdk`](../sentry-react-sdk/SKILL.md) |
| react-router framework, @sentry/react-router, @react-router/dev, react-router reveal | [`sentry-react-router-framework-sdk`](../sentry-react-router-framework-sdk/SKILL.md) |
| tanstack start, tanstack react start, @tanstack/react-start, tanstackstart-react | [`sentry-tanstack-start-sdk`](../sentry-tanstack-start-sdk/SKILL.md) |
| ruby, rails, sinatra, sidekiq, rack | [`sentry-ruby-sdk`](../sentry-ruby-sdk/SKILL.md) |
| svelte, sveltekit | [`sentry-svelte-sdk`](../sentry-svelte-sdk/SKILL.md) |

---

## Finding the DSN

If the user doesn't have their DSN, guide them to find it:

1. Open the Sentry project settings page: `https://sentry.io/settings/projects/`
2. Select the project
3. Click **"Client Keys (DSN)"** in the left sidebar
4. Copy the DSN

You can help the user open the page directly:
```bash
open https://sentry.io/settings/projects/        # macOS
xdg-open https://sentry.io/settings/projects/    # Linux
start https://sentry.io/settings/projects/        # Windows
```

> **Note:** The DSN is public and safe to include in source code. It is not a secret — it only identifies where to send events.

---

Looking for workflows or feature configuration instead? See the [full Skill Tree](../../SKILL_TREE.md).

© getsentry · Apache-2.0 · getsentry/sentry-for-ai

Similar skills

All skills for Agent setup: memory, context, orchestration →
sentry-react-sdk getsentry The skill scans your React app and walks you through a full Sentry setup: errors, tracing, session replay, logging and profiling. CX Codex +1 579installs sentry-go-sdk getsentry The skill scans your Go project and walks you through Sentry setup: errors, tracing, logs, metrics and crons. CX Codex +1 316installs sentry brianlovin Guides an agent through Sentry error capture and performance tracing in Next.js code. Use it while adding Sentry instrumentation to an application. CX Codex +1 2,800installs fix-sentry-issues brianlovin Triages production Sentry errors through Sentry MCP and resolves underlying software defects. Fits investigations of error spikes and Sentry noise cleanup. CX Codex +1 2,700installs Sentry Bug Fixer f A prompt that turns a chat model into a Sentry debugging assistant: read the report, rank the bug, propose a fix, verify it. GP ChatGPT ★ 174,597repo stars sentry-triage official Liz Tom Pulls live Sentry issues into a Copilot canvas, groups them by urgency, and hands each one off to tracking or a fix PR. ★ 40,418repo stars

From the same set34

sentry-fix-issues Finds Sentry errors via MCP, inspects stack traces and breadcrumbs, and helps write fixes. Useful for debugging production issues and triaging backlogs. CX Codex +1 10,000installs sentry-create-alert Creates Sentry alerts and workflow automations via the workflow engine API. Sets up notifications for Slack, PagerDuty, or email directly through agent chat. CX Codex +1 4,100installs sentry-react-native-sdk A skill that walks your agent through Sentry setup in React Native and Expo: it scans the project, proposes a feature set and guides the install steps. CX Codex +1 4,100installs sentry-nextjs-sdk This skill inspects your Next.js project and guides Sentry setup across browser, Node.js, and Edge runtimes. It helps configure error tracking, tracing, and session replays. CX Codex +1 3,600installs sentry-cocoa-sdk This skill walks you through a full Sentry setup for iOS, macOS, tvOS, watchOS and visionOS: it scans the project, proposes a feature set and guides the install. CX Codex +1 3,400installs sentry-node-sdk A wizard skill that scans your backend project and walks you through Sentry setup for server-side JavaScript and TypeScript runtimes. CX Codex +1 3,300installs sentry-sdk-upgrade This skill guides major version upgrades for the Sentry JavaScript SDK, like migrating from v7 to v8 or v9. It finds deprecated APIs, updates imports, and verifies the build. CX Codex +1 3,100installs sentry-react-sdk Walks a React project through full Sentry setup: it scans your dependencies, proposes a feature set, and writes the config. Useful when you want error monitoring wired up without reading the docs end to end. CX Codex +1 3,100installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor