Agent skill · data analytics · jeremylongshore
sentry-common-errors
Troubleshoot common Sentry integration issues and fixes.
Why this skill is useful
Provides specific troubleshooting steps and commands for diagnosing Sentry integration issues that the AI wouldn't reliably generate on its own.
What it needs
Requires sentry-cli installed locally. Requires sentry account access. About 8k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Sentry Common Errors Overview Diagnose and fix the most frequently encountered Sentry SDK integration issues across Node.js, browser, and Python environments. Covers DSN validation, missing events, source map failures, rate limiting, SDK initialization ordering, serverless flush patterns, CORS configuration, and environment tagging. Prerequisites Sentry SDK installed (@sentry/node v8+, @sentry/browser v8+, or sentry-sdk for Python) Access to Sentry dashboard with project admin or member role Application logs available for inspection sentry-cli installed for source map and release operations Instructions Step 1 — Detect the installed SDK and current configuration !npm list @sentry/node @sentry/browser @sentry/react @sentry/nextjs 2>/dev/null head -10 echo "No Node.js Sentry SDK found" !python3 -c "import sentrysdk; print(f'sentry-sdk {sentrysdk.VERSION}')" 2>/dev/null echo "No Python sentry-sdk found" !command -v sentry-cli >/dev/null && sentry-cli --version echo "sentry-cli not installed" Grep the project for Sentry initialization to identify the current configuration: Step 2 — DSN not set or invalid DSN format The DSN (Data Source Name) tells the SDK where to send events. Format: https://<public-key>@<org>.ingest.sentry.io/<project-id> Symptoms: No events arrive. SDK silently does nothing. debug: true shows "No DSN provided." Python equivalent: Step 3 — Events not appearing in dashboard Symptoms: Sentry.captureException() runs without errors, but nothing shows up in the Sentry web UI. Root causes and fixes: 1. beforeSend accidentally returning null: 1. sampleRate set to 0: 1. Missing await Sentry.flush() in serverless / CLI contexts: Python (AWS Lambda): 1. SDK initialized after error occurs: Diagnostic checklist for missing events: Step 4 — Source maps not resolving Symptoms: Stack traces in Sentry show minified variable names and wrong line numbers. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/sentry-common-errors--0bf056