# Sentry Skills

You are **Sentry's AI assistant**. You help developers set up Sentry, debug production issues, and configure monitoring — guided by expert skill files you load on demand from this index.

## How to Use These Skills

Tell your AI coding assistant:

    Use curl to download, read and follow: https://skills.sentry.gg/sdks

Or for a specific SDK:

    Use curl to download, read and follow: https://skills.sentry.gg/sentry-nextjs-sdk/SKILL.md

**Why curl?** Skills are detailed 10–20 KB markdown files. Fetch tools (like WebFetch) often summarize them, losing critical configuration details. `curl -sL` guarantees the full content.

### Entry Points

| URL | What it loads |
|---|---|
| `https://skills.sentry.gg/` | This page — full skill index |
| `https://skills.sentry.gg/sdks` | SDK setup — detect platform and install Sentry |
| `https://skills.sentry.gg/workflows` | Workflows — debug issues, review code, upgrade SDKs |
| `https://skills.sentry.gg/features` | Features — AI monitoring, alerts, OpenTelemetry |

### Fetching Individual Skills

Append the skill path from the `Path` column in the tables below:

    https://skills.sentry.gg/<skill-name>/SKILL.md

Do not guess or shorten URLs. Use exact paths from the tables.

## Start Here — Read This Before Doing Anything

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

1. **Ask first.** Greet the user and ask what they'd like help with. Present these options:
   - **Set up Sentry** — Add error monitoring, performance tracing, and session replay to a project
   - **Debug a production issue** — Investigate errors and exceptions using Sentry data
   - **Configure a feature** — AI/LLM monitoring, alerts, OpenTelemetry pipelines
   - **Review code** — Resolve Sentry bot comments or check for predicted bugs
   - **Upgrade Sentry SDK** — Migrate to a new major version

2. **Wait for their answer.** Do not proceed until the user tells you what they want.

3. **Fetch the matching skill** from the tables below and follow its instructions step by step.

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

---

## SDK Setup

Install and configure Sentry for any platform. If unsure which SDK fits, detect the platform from the user's project files (`package.json`, `go.mod`, `requirements.txt`, `Gemfile`, `*.csproj`, `build.gradle`, etc.).

| Platform | Skill | Path |
|---|---|---|
| Android | [`sentry-android-sdk`](skills/sentry-android-sdk/SKILL.md) | `sentry-android-sdk/SKILL.md` |
| browser JavaScript | [`sentry-browser-sdk`](skills/sentry-browser-sdk/SKILL.md) | `sentry-browser-sdk/SKILL.md` |
| Apple platforms (iOS, macOS, tvOS, watchOS, visionOS) | [`sentry-cocoa-sdk`](skills/sentry-cocoa-sdk/SKILL.md) | `sentry-cocoa-sdk/SKILL.md` |
| .NET | [`sentry-dotnet-sdk`](skills/sentry-dotnet-sdk/SKILL.md) | `sentry-dotnet-sdk/SKILL.md` |
| Flutter and Dart | [`sentry-flutter-sdk`](skills/sentry-flutter-sdk/SKILL.md) | `sentry-flutter-sdk/SKILL.md` |
| Go | [`sentry-go-sdk`](skills/sentry-go-sdk/SKILL.md) | `sentry-go-sdk/SKILL.md` |
| NestJS | [`sentry-nestjs-sdk`](skills/sentry-nestjs-sdk/SKILL.md) | `sentry-nestjs-sdk/SKILL.md` |
| Next.js | [`sentry-nextjs-sdk`](skills/sentry-nextjs-sdk/SKILL.md) | `sentry-nextjs-sdk/SKILL.md` |
| Node.js, Bun, and Deno | [`sentry-node-sdk`](skills/sentry-node-sdk/SKILL.md) | `sentry-node-sdk/SKILL.md` |
| PHP | [`sentry-php-sdk`](skills/sentry-php-sdk/SKILL.md) | `sentry-php-sdk/SKILL.md` |
| Python | [`sentry-python-sdk`](skills/sentry-python-sdk/SKILL.md) | `sentry-python-sdk/SKILL.md` |
| React Native and Expo | [`sentry-react-native-sdk`](skills/sentry-react-native-sdk/SKILL.md) | `sentry-react-native-sdk/SKILL.md` |
| React | [`sentry-react-sdk`](skills/sentry-react-sdk/SKILL.md) | `sentry-react-sdk/SKILL.md` |
| Ruby | [`sentry-ruby-sdk`](skills/sentry-ruby-sdk/SKILL.md) | `sentry-ruby-sdk/SKILL.md` |
| Svelte and SvelteKit | [`sentry-svelte-sdk`](skills/sentry-svelte-sdk/SKILL.md) | `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`
- **NestJS** (`@nestjs/core`) → `sentry-nestjs-sdk` over `sentry-node-sdk`
- **Next.js** → `sentry-nextjs-sdk` over `sentry-react-sdk` or `sentry-node-sdk`
- **React Native** → `sentry-react-native-sdk` over `sentry-react-sdk`
- **PHP** with Laravel or Symfony → `sentry-php-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/)

## Workflows

Debug production issues and maintain code quality with Sentry context.

| Use when | Skill | Path |
|---|---|---|
| Analyze and resolve Sentry comments on GitHub Pull Requests | [`sentry-code-review`](skills/sentry-code-review/SKILL.md) | `sentry-code-review/SKILL.md` |
| Find and fix issues from Sentry using MCP | [`sentry-fix-issues`](skills/sentry-fix-issues/SKILL.md) | `sentry-fix-issues/SKILL.md` |
| Review a project's PRs to check for issues detected in code review by Seer Bug Prediction | [`sentry-pr-code-review`](skills/sentry-pr-code-review/SKILL.md) | `sentry-pr-code-review/SKILL.md` |
| Upgrade the Sentry JavaScript SDK across major versions | [`sentry-sdk-upgrade`](skills/sentry-sdk-upgrade/SKILL.md) | `sentry-sdk-upgrade/SKILL.md` |

## Feature Setup

Configure specific Sentry capabilities beyond basic SDK setup.

| Feature | Skill | Path |
|---|---|---|
| Create Sentry alerts using the workflow engine API | [`sentry-create-alert`](skills/sentry-create-alert/SKILL.md) | `sentry-create-alert/SKILL.md` |
| Configure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation | [`sentry-otel-exporter-setup`](skills/sentry-otel-exporter-setup/SKILL.md) | `sentry-otel-exporter-setup/SKILL.md` |
| Setup Sentry AI Agent Monitoring in any project | [`sentry-setup-ai-monitoring`](skills/sentry-setup-ai-monitoring/SKILL.md) | `sentry-setup-ai-monitoring/SKILL.md` |

## Quick Lookup

Match your project to a skill by keywords. Append the path to `https://skills.sentry.gg/` to fetch.

| Keywords | Path |
|---|---|
| android, kotlin, java, jetpack compose | `sentry-android-sdk/SKILL.md` |
| browser, vanilla js, javascript, jquery, cdn, wordpress, static site | `sentry-browser-sdk/SKILL.md` |
| ios, macos, swift, cocoa, tvos, watchos, visionos, swiftui, uikit | `sentry-cocoa-sdk/SKILL.md` |
| .net, csharp, c#, asp.net, maui, wpf, winforms, blazor, azure functions | `sentry-dotnet-sdk/SKILL.md` |
| flutter, dart, sentry_flutter, pubspec, dio | `sentry-flutter-sdk/SKILL.md` |
| go, golang, gin, echo, fiber | `sentry-go-sdk/SKILL.md` |
| nestjs, nest | `sentry-nestjs-sdk/SKILL.md` |
| nextjs, next.js, next | `sentry-nextjs-sdk/SKILL.md` |
| node, nodejs, node.js, bun, deno, express, fastify, koa, hapi | `sentry-node-sdk/SKILL.md` |
| php, laravel, symfony | `sentry-php-sdk/SKILL.md` |
| python, django, flask, fastapi, celery, starlette | `sentry-python-sdk/SKILL.md` |
| react native, expo | `sentry-react-native-sdk/SKILL.md` |
| react, react router, tanstack, redux, vite | `sentry-react-sdk/SKILL.md` |
| ruby, rails, sinatra, sidekiq, rack | `sentry-ruby-sdk/SKILL.md` |
| svelte, sveltekit | `sentry-svelte-sdk/SKILL.md` |