mirror of
https://github.com/getsentry/sentry-for-ai.git
synced 2026-09-14 14:28:22 +08:00
Giancarlo Buenaflor
22b7274496
* feat(skills): Add span streaming migration skill for Dart Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Document configureScope, drop navigator note in Dart skill Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Remove configureScope section from Dart skill Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Drop experimental notes from Dart span streaming skill Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Drop internal buffer thresholds from verification Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Add startSpan example to Minimal Flutter Setup Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): Fill span-streaming API gaps in Dart skill Document the manual span status setter, retroactive startTimestamp / endTimestamp, and clarify the parentSpan unset-vs-null default in the Dart span streaming skill. These APIs had no documented path before. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
9.6 KiB
9.6 KiB
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.dev/sdks
Or for a specific SDK:
Use curl to download, read and follow: https://skills.sentry.dev/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.dev/ |
This page — full skill index |
https://skills.sentry.dev/sdks |
SDK setup — detect platform and install Sentry |
https://skills.sentry.dev/workflows |
Workflows — debug issues, review code, upgrade SDKs |
https://skills.sentry.dev/features |
Features — AI monitoring, alerts, OpenTelemetry |
Fetching Individual Skills
Append the skill path from the Path column in the tables below:
https://skills.sentry.dev/<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.
-
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
-
Wait for their answer. Do not proceed until the user tells you what they want.
-
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 |
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 |
| Flutter and Dart | sentry-flutter-sdk |
sentry-flutter-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 |
| React Native and Expo | sentry-react-native-sdk |
sentry-react-native-sdk/SKILL.md |
| React Router Framework mode | sentry-react-router-framework-sdk |
sentry-react-router-framework-sdk/SKILL.md |
| React | sentry-react-sdk |
sentry-react-sdk/SKILL.md |
| Ruby | sentry-ruby-sdk |
sentry-ruby-sdk/SKILL.md |
| Svelte and SvelteKit | sentry-svelte-sdk |
sentry-svelte-sdk/SKILL.md |
| TanStack Start React | sentry-tanstack-start-sdk |
sentry-tanstack-start-sdk/SKILL.md |
Platform Detection Priority
When multiple SDKs could match, prefer the more specific one:
- Android (
build.gradlewith android plugin) →sentry-android-sdk - NestJS (
@nestjs/core) →sentry-nestjs-sdkoversentry-node-sdk - Next.js →
sentry-nextjs-sdkoversentry-react-sdkorsentry-node-sdk - React Router Framework (
@sentry/react-routeror@react-router/*) →sentry-react-router-framework-sdkoversentry-react-sdk - TanStack Start React (
@tanstack/react-start) →sentry-tanstack-start-sdkoversentry-react-sdk - React Native →
sentry-react-native-sdkoversentry-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
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 |
sentry-code-review/SKILL.md |
| Find and fix issues from Sentry using MCP | sentry-fix-issues |
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 |
sentry-pr-code-review/SKILL.md |
| Upgrade the Sentry JavaScript SDK across major versions | sentry-sdk-upgrade |
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 |
sentry-create-alert/SKILL.md |
| Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric | sentry-instrumentation-guide |
sentry-instrumentation-guide/SKILL.md |
| Configure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation | sentry-otel-exporter-setup |
sentry-otel-exporter-setup/SKILL.md |
| Setup Sentry AI Agent Monitoring in any project | sentry-setup-ai-monitoring |
sentry-setup-ai-monitoring/SKILL.md |
| Migrate Dart/Flutter SDK to Sentry span streaming (span-first trace lifecycle) | sentry-span-streaming-dart |
sentry-span-streaming-dart/SKILL.md |
| Migrate JavaScript SDK to Sentry span streaming (span-first trace lifecycle) | sentry-span-streaming-js |
sentry-span-streaming-js/SKILL.md |
| Migrate Python SDK to Sentry span streaming (span-first trace lifecycle) | sentry-span-streaming-python |
sentry-span-streaming-python/SKILL.md |
Quick Lookup
Match your project to a skill by keywords. Append the path to https://skills.sentry.dev/ 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 |
| cloudflare, cloudflare workers, cloudflare pages, wrangler, durable objects, d1, hono | sentry-cloudflare-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 |
| elixir, phoenix, plug, liveview, oban, quantum, mix | sentry-elixir-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-router framework, @sentry/react-router, @react-router/dev, react-router reveal | sentry-react-router-framework-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 |
| tanstack start, tanstack react start, @tanstack/react-start, tanstackstart-react | sentry-tanstack-start-sdk/SKILL.md |