getsentry · s1gr1d · Jul 6, 2026 · Jul 7, 2026 · Jul 8, 2026 · s1gr1d
diff --git a/.github/agents/skill-creator.agent.md b/.github/agents/skill-creator.agent.md
@@ -5,7 +5,7 @@ description: >
   any platform or framework. Researches official docs, clones the SDK repo to
   verify APIs against source code, studies existing skills for patterns, and
   produces a full skill bundle (SKILL.md + reference files) with a PR.
-  Use when asked to "create a skill for <platform>" or "add SDK support for <framework>".
+  Use when asked to "create a skill for [platform]" or "add SDK support for [framework]".
 tools:
   - read
   - edit
@@ -44,8 +44,7 @@ Before writing anything, read 2 existing SDK skills to internalize the patterns:
 - **One frontend skill**: read `skills/sentry-nextjs-sdk/SKILL.md` and 2-3 of its `references/*.md` files
 
 Study them for:
-- Frontmatter fields and format
-- "Invoke This Skill When" trigger phrase style
+- Frontmatter fields and format — the `description` carries the "Use when …" trigger phrases (single line, max. 1024 characters, no XML tags); there is no separate "when to use" section in the body
 - Phase 1 detection commands (real bash, not pseudo-code)
 - Phase 2 recommendation matrix (opinionated: always/when detected/optional)
 - Phase 3 guide structure (wizard option, manual setup, reference dispatch table)

diff --git a/SKILL_TREE.md b/SKILL_TREE.md
@@ -97,25 +97,25 @@ 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` |
+| Analyze and resolve comments from sentry[bot] on GitHub pull requests | [`sentry-code-review`](skills/sentry-code-review/SKILL.md) | `sentry-code-review/SKILL.md` |
+| Find and fix production issues from Sentry using the Sentry MCP server | [`sentry-fix-issues`](skills/sentry-fix-issues/SKILL.md) | `sentry-fix-issues/SKILL.md` |
+| Review and fix issues flagged by Seer Bug Prediction in GitHub PR comments | [`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 with guided migration | [`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` |
-| Decide which Sentry signal to reach for when instrumenting code — error, span, span attribute, log, or metric | [`sentry-instrumentation-guide`](skills/sentry-instrumentation-guide/SKILL.md) | `sentry-instrumentation-guide/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` |
+| Create Sentry alerts using the workflow engine API (currently beta) | [`sentry-create-alert`](skills/sentry-create-alert/SKILL.md) | `sentry-create-alert/SKILL.md` |
+| Decision framework for choosing the right Sentry signal when instrumenting code — error, span, span attribute, log, or metric | [`sentry-instrumentation-guide`](skills/sentry-instrumentation-guide/SKILL.md) | `sentry-instrumentation-guide/SKILL.md` |
+| Configure the OpenTelemetry Collector with the 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` |
+| Set up Sentry AI Agent Monitoring to track LLM calls, agent executions, tool usage, and token consumption | [`sentry-setup-ai-monitoring`](skills/sentry-setup-ai-monitoring/SKILL.md) | `sentry-setup-ai-monitoring/SKILL.md` |
 | Full Sentry Snapshots setup for Apple/Cocoa projects | [`sentry-snapshots-cocoa`](skills/sentry-snapshots-cocoa/SKILL.md) | `sentry-snapshots-cocoa/SKILL.md` |
-| Migrate Dart/Flutter SDK to Sentry span streaming (span-first trace lifecycle) | [`sentry-span-streaming-dart`](skills/sentry-span-streaming-dart/SKILL.md) | `sentry-span-streaming-dart/SKILL.md` |
-| Migrate JavaScript SDK to Sentry span streaming (span-first trace lifecycle) | [`sentry-span-streaming-js`](skills/sentry-span-streaming-js/SKILL.md) | `sentry-span-streaming-js/SKILL.md` |
-| Migrate Python SDK to Sentry span streaming (span-first trace lifecycle) | [`sentry-span-streaming-python`](skills/sentry-span-streaming-python/SKILL.md) | `sentry-span-streaming-python/SKILL.md` |
+| Migrate the Dart and Flutter Sentry SDK from transaction-based to streamed span delivery (span-first trace lifecycle) | [`sentry-span-streaming-dart`](skills/sentry-span-streaming-dart/SKILL.md) | `sentry-span-streaming-dart/SKILL.md` |
+| Migrate the JavaScript Sentry SDK from transaction-based to streamed span delivery (span-first trace lifecycle) | [`sentry-span-streaming-js`](skills/sentry-span-streaming-js/SKILL.md) | `sentry-span-streaming-js/SKILL.md` |
+| Migrate the Python Sentry SDK from transaction-based to streamed span delivery (span-first trace lifecycle) | [`sentry-span-streaming-python`](skills/sentry-span-streaming-python/SKILL.md) | `sentry-span-streaming-python/SKILL.md` |
 
 ## Quick Lookup
 

diff --git a/skills/sentry-android-sdk/SKILL.md b/skills/sentry-android-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-android-sdk
-description: Full Sentry SDK setup for Android. Use when asked to "add Sentry to Android", "install sentry-android", "setup Sentry in Android", or configure error monitoring, tracing, profiling, session replay, or logging for Android applications. Supports Kotlin and Java codebases.
+description: Full Sentry SDK setup for Android. Use when asked to "add Sentry to Android", "install sentry-android", or set up crash reporting, ANR detection, error monitoring, tracing, profiling, session replay, or logging in a Kotlin or Java Android app. Covers native (NDK) crashes, app startup performance, io.sentry:sentry-android, and Jetpack Compose. Supports Kotlin and Java codebases.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,13 +13,6 @@ disable-model-invocation: true
 
 Opinionated wizard that scans your Android project and guides you through complete Sentry setup — error monitoring, tracing, profiling, session replay, logging, and more.
 
-## Invoke This Skill When
-
-- User asks to "add Sentry to Android" or "set up Sentry" in an Android app
-- User wants error monitoring, crash reporting, ANR detection, tracing, profiling, session replay, or logging in Android
-- User mentions `sentry-android`, `io.sentry:sentry-android`, mobile crash tracking, or Sentry for Kotlin/Java Android
-- User wants to monitor native (NDK) crashes, application not responding (ANR) events, or app startup performance
-
 > **Note:** SDK versions and APIs below reflect current Sentry docs at time of writing (`io.sentry:sentry-android:8.33.0`, Gradle plugin `6.1.0`).
 > Always verify against [docs.sentry.io/platforms/android/](https://docs.sentry.io/platforms/android/) before implementing.
 

diff --git a/skills/sentry-browser-sdk/SKILL.md b/skills/sentry-browser-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-browser-sdk
-description: Full Sentry SDK setup for browser JavaScript. Use when asked to "add Sentry to a website", "install @sentry/browser", or configure error monitoring, tracing, session replay, or logging for vanilla JavaScript, jQuery, static sites, or WordPress.
+description: Full Sentry SDK setup for browser JavaScript. Use when asked to "add Sentry to a website", "install @sentry/browser", set up the Loader Script or CDN snippet, or configure error monitoring, tracing, session replay, or logging for plain JavaScript with no framework-specific SDK. Covers vanilla JS, jQuery, WordPress, Shopify, Squarespace, and static HTML sites.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,14 +13,6 @@ disable-model-invocation: true
 
 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/](https://docs.sentry.io/platforms/javascript/) before implementing.
 

diff --git a/skills/sentry-cloudflare-sdk/SKILL.md b/skills/sentry-cloudflare-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-cloudflare-sdk
-description: Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudflare Workers", "install @sentry/cloudflare", or configure error monitoring, tracing, logging, crons, or AI monitoring for Cloudflare Workers, Pages, Durable Objects, Queues, Workflows, or Hono on Cloudflare.
+description: Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudflare Workers", "install @sentry/cloudflare", or configure error monitoring, tracing, logging, crons, or AI monitoring on Cloudflare. Covers withSentry, sentryPagesPlugin, instrumentDurableObjectWithSentry, and monitoring Durable Objects, D1, Queues, Workflows, Scheduled handlers, Email handlers, and Hono.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,14 +13,6 @@ disable-model-invocation: true
 
 Opinionated wizard that scans your Cloudflare project and guides you through complete Sentry setup for Workers, Pages, Durable Objects, Queues, Workflows, and Hono.
 
-## Invoke This Skill When
-
-- User asks to "add Sentry to Cloudflare Workers" or "set up Sentry" in a Cloudflare project
-- User wants to install or configure `@sentry/cloudflare`
-- User wants error monitoring, tracing, logging, crons, or AI monitoring for Cloudflare Workers or Pages
-- User asks about `withSentry`, `sentryPagesPlugin`, `instrumentDurableObjectWithSentry`, or `instrumentD1WithSentry`
-- User wants to monitor Durable Objects, Queues, Workflows, Scheduled handlers, or Email handlers on Cloudflare
-
 > **Note:** SDK versions and APIs below reflect current Sentry docs at time of writing (`@sentry/cloudflare` v10.61.0).
 > Always verify against [docs.sentry.io/platforms/javascript/guides/cloudflare/](https://docs.sentry.io/platforms/javascript/guides/cloudflare/) before implementing.
 

diff --git a/skills/sentry-cocoa-sdk/SKILL.md b/skills/sentry-cocoa-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-cocoa-sdk
-description: Full Sentry SDK setup for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS). Use when asked to "add Sentry to iOS", "add Sentry to Swift", "install sentry-cocoa", or configure error monitoring, tracing, profiling, session replay, logging, or metrics for Apple applications. Supports SwiftUI and UIKit.
+description: Full Sentry SDK setup for Apple platforms (iOS, macOS, tvOS, watchOS, visionOS). Use when asked to "add Sentry to iOS/macOS", "add Sentry to Swift", "install sentry-cocoa", or set up crash reporting, error monitoring, tracing, profiling, session replay, logging, or metrics for Apple apps. Covers SentrySDK setup, app hangs, watchdog terminations, and performance in Swift or Objective-C. Supports SwiftUI and UIKit.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,13 +13,6 @@ disable-model-invocation: true
 
 Opinionated wizard that scans your Apple project and guides you through complete Sentry setup.
 
-## Invoke This Skill When
-
-- User asks to "add Sentry to iOS/macOS/tvOS" or "set up Sentry" in an Apple app
-- User wants error monitoring, tracing, profiling, session replay, or logging in Swift/ObjC, or metrics in Swift
-- User mentions `sentry-cocoa`, `SentrySDK`, or the Apple/iOS Sentry SDK
-- User wants to monitor crashes, app hangs, watchdog terminations, or performance
-
 > **Note:** SDK versions and APIs below reflect Sentry docs at time of writing (sentry-cocoa 9.15.0).
 > Always verify against [docs.sentry.io/platforms/apple/](https://docs.sentry.io/platforms/apple/) before implementing.
 

diff --git a/skills/sentry-code-review/SKILL.md b/skills/sentry-code-review/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-code-review
-description: Analyze and resolve Sentry comments on GitHub Pull Requests. Use this when asked to review or fix issues identified by Sentry in PR comments. Can review specific PRs by number or automatically find recent PRs with Sentry feedback.
+description: Analyze and resolve comments from sentry[bot] on GitHub pull requests. Use when asked to "review Sentry comments", "fix Sentry bot feedback", or resolve issues flagged by Sentry in PR review comments. Reviews a specific PR by number or automatically finds recent PRs with Sentry feedback, and processes only sentry[bot] comments while ignoring other bots. Requires the gh CLI.
 allowed-tools: Read, Edit, Write, Bash, Grep, Glob, WebFetch, AskUserQuestion
 category: workflow
 parent: sentry-workflow

diff --git a/skills/sentry-create-alert/SKILL.md b/skills/sentry-create-alert/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-create-alert
-description: Create Sentry alerts using the workflow engine API. Use when asked to create alerts, set up notifications, configure issue priority alerts, or build workflow automations. Supports email, Slack, PagerDuty, Discord, and other notification actions.
+description: Create Sentry alerts using the workflow engine API (currently beta). Use when asked to "create a Sentry alert", "set up notifications", configure issue priority or de-escalation alerts, get notified when issues match conditions, or build workflow automations. Supports email, Slack, PagerDuty, Discord, and other notification actions. Requires curl and an org auth token with alerts:write scope.
 license: Apache-2.0
 category: feature-setup
 parent: sentry-feature-setup
@@ -15,13 +15,6 @@ Create alerts via Sentry's workflow engine API.
 
 **Note:** This API is currently in **beta** and may be subject to change. It is part of New Monitors and Alerts and may not be viewable in the legacy Alerts UI.
 
-## Invoke This Skill When
-
-- User asks to "create a Sentry alert" or "set up notifications"
-- User wants to be emailed or notified when issues match certain conditions
-- User mentions priority alerts, de-escalation alerts, or workflow automations
-- User wants to configure Slack, PagerDuty, or email notifications for Sentry issues
-
 ## Prerequisites
 
 - `curl` available in shell

diff --git a/skills/sentry-dotnet-sdk/SKILL.md b/skills/sentry-dotnet-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-dotnet-sdk
-description: Full Sentry SDK setup for .NET. Use when asked to "add Sentry to .NET", "install Sentry for C#", or configure error monitoring, tracing, profiling, logging, or crons for ASP.NET Core, MAUI, WPF, WinForms, Blazor, Azure Functions, or any other .NET application.
+description: Full Sentry SDK setup for .NET. Use when asked to "add Sentry to .NET", "install Sentry for C#", "set up Sentry in ASP.NET Core", or configure error monitoring, tracing, profiling, logging, or crons for a .NET app. Covers SentrySdk.Init, UseSentry, SentryOptions, BeforeSend, TracesSampleRate, and symbol upload across ASP.NET Core, MAUI, WPF, WinForms, Blazor, and Azure Functions.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,14 +13,6 @@ disable-model-invocation: true
 
 Opinionated wizard that scans your .NET project and guides you through complete Sentry setup: error monitoring, distributed tracing, profiling, structured logging, and cron monitoring across all major .NET frameworks.
 
-## Invoke This Skill When
-
-- User asks to "add Sentry to .NET", "set up Sentry in C#", or "install Sentry for ASP.NET Core"
-- User wants error monitoring, tracing, profiling, logging, or crons for a .NET app
-- User mentions `SentrySdk.Init`, `UseSentry`, `Sentry.AspNetCore`, or `Sentry.Maui`
-- User wants to capture unhandled exceptions in WPF, WinForms, MAUI, or Azure Functions
-- User asks about `SentryOptions`, `BeforeSend`, `TracesSampleRate`, or symbol upload
-
 > **Note:** SDK version and APIs below reflect `Sentry` NuGet packages ≥6.1.0 (OTLP export requires ≥6.5.0).
 > Always verify against [docs.sentry.io/platforms/dotnet/](https://docs.sentry.io/platforms/dotnet/) before implementing.
 

diff --git a/skills/sentry-elixir-sdk/SKILL.md b/skills/sentry-elixir-sdk/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-elixir-sdk
-description: Full Sentry SDK setup for Elixir. Use when asked to "add Sentry to Elixir", "install sentry for Elixir", or configure error monitoring, tracing, logging, or crons for Elixir, Phoenix, or Plug applications. Supports Phoenix, Plug, LiveView, Oban, and Quantum.
+description: Full Sentry SDK setup for Elixir. Use when asked to "add Sentry to Elixir", "install the sentry hex package" (getsentry/sentry-elixir), or configure error monitoring, tracing, logging, or crons for Elixir or Phoenix apps. Covers capturing exceptions, Plug errors, LiveView errors, and scheduled jobs. Supports Phoenix, Plug, LiveView, Oban, and Quantum.
 license: Apache-2.0
 category: sdk-setup
 parent: sentry-sdk-setup
@@ -13,13 +13,6 @@ disable-model-invocation: true
 
 Opinionated wizard that scans your Elixir project and guides you through complete Sentry setup.
 
-## Invoke This Skill When
-
-- User asks to "add Sentry to Elixir" or "set up Sentry" in an Elixir or Phoenix app
-- User wants error monitoring, tracing, logging, or crons in Elixir or Phoenix
-- User mentions `sentry` hex package, `getsentry/sentry-elixir`, or Elixir Sentry SDK
-- User wants to monitor exceptions, Plug errors, LiveView errors, or scheduled jobs
-
 > **Note:** SDK versions and APIs below reflect Sentry docs at time of writing (sentry v13.2.0, requires Elixir ~> 1.13).
 > Always verify against [docs.sentry.io/platforms/elixir/](https://docs.sentry.io/platforms/elixir/) before implementing.
 

diff --git a/skills/sentry-fix-issues/SKILL.md b/skills/sentry-fix-issues/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: sentry-fix-issues
-description: Find and fix issues from Sentry using MCP. Use when asked to fix Sentry errors, debug production issues, investigate exceptions, or resolve bugs reported in Sentry. Methodically analyzes stack traces, breadcrumbs, traces, and context to identify root causes.
+description: Find and fix production issues from Sentry using the Sentry MCP server. Use when asked to "fix Sentry issues", "resolve Sentry errors", "debug production bugs", or "investigate exceptions", when triaging the Sentry backlog, or when given a Sentry issue ID or error message. Methodically analyzes stack traces, breadcrumbs, traces, and context to identify root causes.
 license: Apache-2.0
 category: workflow
 parent: sentry-workflow
@@ -13,13 +13,6 @@ disable-model-invocation: true
 
 Discover, analyze, and fix production issues using Sentry's full debugging capabilities.
 
-## Invoke This Skill When
-
-- User asks to "fix Sentry issues" or "resolve Sentry errors"
-- User wants to "debug production bugs" or "investigate exceptions"
-- User mentions issue IDs, error messages, or asks about recent failures
-- User wants to triage or work through their Sentry backlog
-
 ## Prerequisites
 
 - Sentry MCP server configured and connected