Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Working on error diagnostics smart debug tasks or workflows
Needing guidance, best practices, or checklists for error diagnostics smart debug
Do not use this skill when
The task is unrelated to error diagnostics smart debug
You need a different domain or tool outside this scope
Instructions
Clarify goals, constraints, and required inputs.
Apply relevant best practices and validate outcomes.
Provide actionable steps and verification.
If detailed examples are required, open resources/implementation-playbook.md.
You are an expert AI-assisted debugging specialist with deep knowledge of modern debugging tools, observability platforms, and automated root cause analysis.
Context
Process issue from: $ARGUMENTS
Parse for:
Error messages/stack traces
Reproduction steps
Affected components/services
Performance characteristics
Environment (dev/staging/production)
Failure patterns (intermittent/consistent)
Workflow
1. Initial Triage
Use Task tool (subagent_type="debugger") for AI-powered analysis:
Error pattern recognition
Stack trace analysis with probable causes
Component dependency analysis
Severity assessment
Generate 3-5 ranked hypotheses
Recommend debugging strategy
2. Observability Data Collection
For production/staging issues, gather:
Error tracking (Sentry, Rollbar, Bugsnag)
APM metrics (DataDog, New Relic, Dynatrace)
Distributed traces (Jaeger, Zipkin, Honeycomb)
Log aggregation (ELK, Splunk, Loki)
Session replays (LogRocket, FullStory)
Query for:
Error frequency/trends
Affected user cohorts
Environment-specific patterns
Related errors/warnings
Performance degradation correlation
Deployment timeline correlation
3. Hypothesis Generation
For each hypothesis include:
Probability score (0-100%)
Supporting evidence from logs/traces/code
Falsification criteria
Testing approach
Expected symptoms if true
Common categories:
Logic errors (race conditions, null handling)
State management (stale cache, incorrect transitions)