Skip to content

Commit 092a283

Browse files
ref(skills): stop the workflow/feature routers pointing at legacy skills (#275)
sentry-workflow and sentry-feature-setup still routed to skills that moved to skills-legacy/ — sentry-fix-issues, the three sentry-span-streaming-* skills, sentry-instrumentation-guide, and sentry-instrument-logging. Those targets are excluded from the plugin build and are not served by skills.sentry.dev, so the links dangle (404 over the proxy, missing skill in the shipped plugin). Drop those entries from both routers (rules + tables), trim the descriptions and intros accordingly, and point production-issue debugging at the standalone sentry-debug-issue skill and signal instrumentation at sentry-instrument.
1 parent a3c961f commit 092a283

2 files changed

Lines changed: 13 additions & 18 deletions

File tree

skills/sentry-feature-setup/SKILL.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: sentry-feature-setup
3-
description: Configure specific Sentry features beyond basic SDK setup. Use when asked to monitor AI/LLM calls, set up OpenTelemetry pipelines, create alerts and notifications, enable span streaming, or set up Sentry Snapshots.
3+
description: Configure specific Sentry features beyond basic SDK setup. Use when asked to monitor AI/LLM calls, set up OpenTelemetry pipelines, create alerts and notifications, or set up Sentry Snapshots.
44
license: Apache-2.0
55
role: router
66
---
@@ -9,7 +9,7 @@ role: router
99
1010
# Sentry Feature Setup
1111

12-
Configure specific Sentry capabilities beyond basic SDK setup — AI monitoring, OpenTelemetry pipelines, alerts, and deciding which signal to instrument where. This page helps you find the right feature skill for your task.
12+
Configure specific Sentry capabilities beyond basic SDK setup — AI monitoring, OpenTelemetry pipelines, alerts, and Sentry Snapshots. This page helps you find the right feature skill for your task.
1313

1414
## Start Here — Read This Before Doing Anything
1515

@@ -18,12 +18,12 @@ Configure specific Sentry capabilities beyond basic SDK setup — AI monitoring,
1818
1. If the user mentions **AI monitoring, LLM tracing, conversations, or instrumenting an AI SDK** (OpenAI, Anthropic, LangChain, Vercel AI, Google GenAI, Pydantic AI) → `sentry-setup-ai-monitoring`
1919
2. If the user mentions **OpenTelemetry, OTel Collector, or multi-service telemetry routing**`sentry-otel-exporter-setup`
2020
3. If the user mentions **alerts, notifications, on-call, Slack/PagerDuty/Discord integration, or workflow rules**`sentry-create-alert`
21-
4. If the user mentions **span streaming, traceLifecycle, trace_lifecycle, spanStreamingIntegration, or switching from transactions to streamed spans**`sentry-span-streaming-js` (JavaScript), `sentry-span-streaming-python` (Python), or `sentry-span-streaming-dart` (Dart/Flutter)
22-
5. If the user is unsure **which signal to use** — log vs span vs metric, "what to instrument where", or how to choose between errors, traces, logs, and metrics → `sentry-instrumentation-guide`
23-
6. If the user mentions **Apple/Cocoa snapshot testing or Sentry Snapshots for Apple platforms** — SnapshotPreviews, Apple Snapshots, Cocoa snapshots, Xcode snapshot testing, Swift previews for Sentry Snapshots, iOS, macOS, tvOS, watchOS, or visionOS → `sentry-snapshots-cocoa`.
21+
4. If the user mentions **Apple/Cocoa snapshot testing or Sentry Snapshots for Apple platforms** — SnapshotPreviews, Apple Snapshots, Cocoa snapshots, Xcode snapshot testing, Swift previews for Sentry Snapshots, iOS, macOS, tvOS, watchOS, or visionOS → `sentry-snapshots-cocoa`.
2422

2523
When unclear, **ask the user** which feature they want to configure. Do not guess.
2624

25+
> Instrumenting a signal (tracing/spans, logging, metrics, span streaming, or deciding what to emit) is now part of the standalone `sentry-instrument` skill.
26+
2727
---
2828

2929
## Feature Skills
@@ -34,11 +34,6 @@ When unclear, **ask the user** which feature they want to configure. Do not gues
3434
| Sentry Snapshots for Apple/Cocoa — upload Apple snapshot images to Sentry; prefer SnapshotPreviews when Swift previews exist | [`sentry-snapshots-cocoa`](../sentry-snapshots-cocoa/SKILL.md) |
3535
| OpenTelemetry Collector with Sentry Exporter — multi-project routing, automatic project creation | [`sentry-otel-exporter-setup`](../sentry-otel-exporter-setup/SKILL.md) |
3636
| Alerts via workflow engine API — email, Slack, PagerDuty, Discord | [`sentry-create-alert`](../sentry-create-alert/SKILL.md) |
37-
| Span streaming (JavaScript) — migrate from transaction-based to streamed span delivery | [`sentry-span-streaming-js`](../sentry-span-streaming-js/SKILL.md) |
38-
| Span streaming (Python) — migrate from transaction-based to streamed span delivery | [`sentry-span-streaming-python`](../sentry-span-streaming-python/SKILL.md) |
39-
| Span streaming (Dart/Flutter) — migrate from transaction-based to streamed span delivery | [`sentry-span-streaming-dart`](../sentry-span-streaming-dart/SKILL.md) |
40-
| Instrumentation guide — decide which signal to reach for (error vs span vs log vs metric), "what to instrument where" | [`sentry-instrumentation-guide`](../sentry-instrumentation-guide/SKILL.md) |
41-
| Instruments structured Sentry logs in a new or existing application | [`sentry-instrument-logging`](../sentry-instrument-logging/SKILL.md) |
4237

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

skills/sentry-workflow/SKILL.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: sentry-workflow
3-
description: Fix production issues and review code with Sentry context. Use when asked to fix Sentry errors, debug issues, triage exceptions, review PR comments from Sentry, or resolve bugs.
3+
description: Review code and keep Sentry SDKs up to date. Use when asked to resolve Sentry bot comments on a PR, address Seer bug predictions in PR reviews, or upgrade the Sentry SDK across major versions.
44
license: Apache-2.0
55
role: router
66
---
@@ -9,26 +9,26 @@ role: router
99
1010
# Sentry Workflows
1111

12-
Debug production issues and maintain code quality with Sentry context. This page helps you find the right workflow skill for your task.
12+
Maintain code quality and keep your Sentry SDK up to date. This page helps you find the right workflow skill for your task.
1313

1414
## Start Here — Read This Before Doing Anything
1515

1616
**Do not skip this section.** Do not assume which workflow the user needs. Ask first.
1717

18-
1. If the user mentions **fixing errors, debugging exceptions, or investigating production issues**`sentry-fix-issues`
19-
2. If the user mentions **Sentry bot comments or `sentry[bot]` on a PR**`sentry-code-review`
20-
3. If the user mentions **Seer, bug prediction, or reviewing PRs for predicted issues**`sentry-pr-code-review`
21-
4. If the user mentions **upgrading Sentry, migrating SDK versions, or fixing deprecated APIs**`sentry-sdk-upgrade`
18+
1. If the user mentions **Sentry bot comments or `sentry[bot]` on a PR**`sentry-code-review`
19+
2. If the user mentions **Seer, bug prediction, or reviewing PRs for predicted issues**`sentry-pr-code-review`
20+
3. If the user mentions **upgrading Sentry, migrating SDK versions, or fixing deprecated APIs**`sentry-sdk-upgrade`
2221

23-
When unclear, **ask the user** whether the task involves live production issues, PR review comments, or SDK upgrades. Do not guess.
22+
When unclear, **ask the user** whether the task involves PR review comments or SDK upgrades. Do not guess.
23+
24+
> Fixing or investigating a production issue? That's the standalone `sentry-debug-issue` skill.
2425
2526
---
2627

2728
## Workflow Skills
2829

2930
| Use when | Skill |
3031
|---|---|
31-
| Finding and fixing production issues — stack traces, breadcrumbs, event data | [`sentry-fix-issues`](../sentry-fix-issues/SKILL.md) |
3232
| Resolving comments from `sentry[bot]` on GitHub PRs | [`sentry-code-review`](../sentry-code-review/SKILL.md) |
3333
| Fixing issues detected by Seer Bug Prediction in PR reviews | [`sentry-pr-code-review`](../sentry-pr-code-review/SKILL.md) |
3434
| Upgrading the Sentry JavaScript SDK — migration guides, breaking changes, deprecated APIs | [`sentry-sdk-upgrade`](../sentry-sdk-upgrade/SKILL.md) |

0 commit comments

Comments
 (0)