sentry-release-triage

Inspects Sentry SDK setup, release wiring, and source maps to produce a triage plan.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill sentry-release-triage-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sentry-release-triage
Source: https://github.com/gmackie/agent-skills/tree/main/skills/sentry-release-triage
Command: npx skills add https://github.com/gmackie/agent-skills --skill sentry-release-triage-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve? Teams that install Sentry often assume error tracking works, only to discover missing source maps, collapsed environments, or absent release naming after shipping. This Skill audits an existing Sentry integration and turns scattered configuration into a focused release-readiness triage plan. ## Core Features & Use Cases - Surface Inventory: Runs a helper script to detect Sentry packages, config files, environment variables, and release or source-map hooks across the repo. - Release Hygiene Review: Checks intentional release naming, distinguishable environment tags, and source-map upload timing before errors occur. - Integration Drift Detection: Flags configs without runtime initialization, missing DSN or auth tokens, and ad hoc captureException calls lacking coherent coverage. - Use Case: Before shipping a Next.js release, run the triage to confirm source maps upload in CI and environments are separated, then receive a dated triage plan under docs/observability/. ## Quick Start Ask the agent to run the Sentry release triage on this repository and write a triage plan covering release naming, environments, and source-map coverage.

Frequently Asked Questions about sentry-release-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify Sentry release readiness before shipping?▼

Run the inspect-sentry-surface.sh helper against your repo to inventory Sentry packages, config files, and env vars. Then review release naming, environment tags, and source-map upload timing, and write the findings into a triage plan under docs/observability/.

How to check if Sentry source maps are uploaded correctly?▼

Check whether source maps are generated and uploaded before errors occur in a given release, typically via CI hooks or sentry-cli calls. The skill flags cases where source-map upload is implied by config but not actually wired.

Does this work with Next.js and Node Sentry SDKs?▼

Yes, the inventory script detects @sentry/browser, @sentry/nextjs, and @sentry/node packages in package.json. It also finds framework config files like sentry.*.config.* and runtime markers such as Sentry.init and ErrorBoundary.

Why does Sentry show unminified stack traces after release?▼

This usually means source maps were not generated or uploaded for that release, or the release name in the app does not match the uploaded artifacts. The triage review explicitly checks release naming and upload wiring to catch this.

When should I not use Sentry release triage?▼

Skip it when the repo has no Sentry SDK, config files, or code markers like Sentry.init or captureException, since the skill does not apply cleanly. It is also not a general logging or incident-response skill.