What problem does it solve?
This Skill helps you systematically troubleshoot Go programs when you face crashes, panics, deadlocks, hangs, data races, or unexpected logic behavior, by forcing a disciplined evidence-first workflow that finds the real root cause.
Core Features & Use Cases
- Decision-tree driven triage: Quickly route your issue to the right debugging workflow based on the observed symptom (compile errors, wrong output, crashes, hangs, CPU/memory spikes).
- Golden Rules for safe debugging: Enforces “read the error first”, “reproduce before you fix”, “one hypothesis at a time”, and “fix the root cause—not the symptom”.
- Targeted tooling guidance: Covers practical escalation paths using pprof, Delve (dlv), race detection (-race), GOTRACEBACK, and GODEBUG tracing.
- Common Go pitfall playbooks: Provides concrete patterns for frequent failure modes like typed-nil interface gotchas, defer-in-loop leaks, WaitGroup misuse, closed-channel select busy loops, fatal concurrent map access, and more.
- Production-aware debugging: Includes guardrails for capturing profiles safely and avoiding unsafe/unauthenticated exposure of profiling endpoints.
Quick Start
Use the golang-troubleshooting skill when your Go service is failing and you need a step-by-step plan to reproduce the issue, collect evidence, and trace backward to the root cause before changing code.
