plugins/debugging/skills/debug-production-error/SKILL.md
Debug production errors using Sentry MCP tools. Searches issues, analyzes stack traces, identifies root causes, and suggests fixes. Use when the user mentions a Sentry error, production exception, stack trace, error monitoring, crash report, or unhandled exception.
npx skillsauth add coalesce-labs/catalyst debug-production-errorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Investigate production errors using Sentry's error tracking, stack traces, and context.
SENTRY_AUTH_TOKENSENTRY_ORGSENTRY_PROJECT/debug-production-error <error-description-or-id>
Examples:
/debug-production-error "TypeError in checkout flow"
/debug-production-error "ISSUE-123"
/debug-production-error "errors from last deployment"
/debug-production-error "unhandled exceptions this week"
Uses Sentry MCP tools to:
When this plugin is enabled, you have access to ~19 Sentry tools:
Error Search & Analysis:
Stack Trace Analysis:
Context & Metadata:
Issue Management:
Root Cause Analysis (Seer AI):
/debug-production-error "Show me details for MYAPP-456 including stack trace and user context"
/debug-production-error "Find all TypeError exceptions in the last 24 hours"
/debug-production-error "What new errors appeared after release v2.3.0?"
/debug-production-error "Show unresolved errors affecting more than 100 users"
Analysis typically includes:
Error Overview:
Stack Trace:
User Context:
Root Cause (when Seer analysis available):
/debug-production-error "production errors in payment service"
/debug-production-error "spike in errors between 2pm-3pm today"
/debug-production-error "errors for [email protected]"
If you have both plugins enabled:
# Enable both
/plugin enable catalyst-debugging
/plugin enable catalyst-analytics
# Combined analysis
> "Show me errors in checkout AND how many users abandoned checkout today"
After identifying root cause:
> "Create a GitHub issue for this error with the stack trace and fix recommendations"
After finding the bug:
/catalyst-dev:create-plan "Fix the TypeError in checkout.ts based on Sentry analysis"
This plugin adds ~20,670 tokens to your context window. Disable when debugging is complete:
/plugin disable catalyst-debugging
See also: /catalyst-debugging:error-impact-analysis, /catalyst-debugging:trace-analysis
testing
Phase-agent that fixes a failing verify verdict so the pipeline self-heals instead of stalling to needs-human (CTL-653). Reads `${ORCH_DIR}/workers/<ticket>/verify.json`, fixes the `findings[]` (every severity:"high" plus the regression_risk drivers) directly via Edit/Write, commits the remediation, and emits `phase.remediate.complete.<ticket>`. The scheduler's router then re-dispatches `verify` to re-check (the verify⇄remediate cycle, cap 3). Dispatched as a `claude --bg` job by `phase-agent-dispatch`, which invokes it via slash command — hence `user-invocable: true`.
development
Phase agent for the verify step of the 9-phase orchestrator pipeline (CTL-450). NEW skill — has no canonical wrapper. Runs read-only adversarial verification against the implement-phase diff: tsc, tests, lint, security scan, reward-hacking scan, code review, test coverage, silent-failure hunt. Writes ${ORCH_DIR}/workers/<TICKET>/verify.json then emits phase.verify.complete.<ticket>. Reads phase-implement.json as its prior-phase artifact. NEVER writes application code — only test files allowed. Spawned via phase-agent-dispatch via slash command — hence `user-invocable: true`.
tools
--- name: phase-triage description: Phase agent that triages a Linear ticket — expands acronyms, classifies (feature/bug/docs/refactor/chore), identifies dependencies, estimates scope, writes triage.json, and posts a triage analysis comment to Linear. Triage completion is signaled by that comment plus the local triage.json — there is no `triaged` label. Emits phase.triage.complete.<TICKET> on success and phase.triage.failed.<TICKET> on error. Dispatched by the phase-agent orchestrator (CTL-452)
testing
Phase agent for the review step of the 9-phase orchestrator pipeline (CTL-450). Wraps the /review skill (gstack) — explicitly skips /ultrareview per user decision. Reads verify.json from the prior phase, runs /review against the diff, writes ${ORCH_DIR}/workers/<TICKET>/review.json, and creates a remediation commit for any HIGH-severity finding that has a deterministic fix. Emits phase.review.complete.<ticket>. Spawned via phase-agent-dispatch via slash command — hence `user-invocable: true`.