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
development
Migrate a single-harness repo to the dual-harness layout so both Claude Code and Codex load the same instructions and skills — AGENTS.md as the portable canonical doc, a thin CLAUDE.md `@AGENTS.md` bridge, and a `.agents/skills` dir with a `.claude/skills` symlink onto it. Use when asked to migrate to dual-harness, make this repo work in both Claude and Codex, or for agent metadata cleanup.
tools
Goal-driven senior-engineer pipeline-unstick sweep (CTL-1176 rung 3). Given the stuck/failed/needs-human set (or ONE ticket handed by the recovery router), its GOAL is to get the pipeline MOVING again — not to fix one ticket's review findings (that is phase-remediate). It runs AFTER the eyes (diagnostician evidence) and the hands (deterministic unstuck-sweep seams) have already tried, and it CONSUMES their output from a recovery-pass.json brief rather than re-diagnosing or redoing their narrow work. It acts like a senior engineer with full tool access — it resolves merge conflicts, rebases, force-pushes, merges green PRs, and re-dispatches stalled phases AUTONOMOUSLY — and escalates to the operator ONLY for a genuine value judgment / something that degrades other functionality / a real cost-benefit trade-off / a serious architecture change / an ADR conflict. On escalation it AUTHORS the operator inbox row + the push notification (executive-voiced). Dispatched as a `claude --bg` job by phase-agent-dispatch via slash command, AND invocable bare by the operator as a sweep — hence `user-invocable: true`. Ships behind CATALYST_RECOVERY_PASS (off by default — no live behavior change until shadow/enforce).
tools
Diagnose and fix Catalyst setup issues. Validates tools, database, config, OTel, direnv, and thoughts. Automatically fixes what it can — creates directories, initializes the database, sets WAL mode, runs migrations. Use for new installs, upgrades, or when something isn't working.
tools
--- name: phase-triage description: Phase agent that triages a Linear ticket — expands acronyms, classifies (feature/bug/docs/refactor/chore), identifies genuine blockers (a semantic second-pass over the backlog — NOT a prose scrape; CTL-838), 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.fai