go-troubleshooting

Installation
SKILL.md

Go Troubleshooting

Diagnosis before fixes. Reproduce, observe, localize, then change code. Never "fix" a symptom you haven't explained — the bug will move.

1. Pick the Procedure by Symptom

Symptom Procedure
Crash with stack trace §2 Read the panic
Program hangs / requests stall §3 Dump goroutines, find the block
fatal error: all goroutines are asleep §3 — Go detected total deadlock
Memory grows until OOM §4 Heap profile diff
Goroutine count grows §5 Goroutine profile diff
Intermittent corrupt data / weird values §6 Race detector
Need to inspect state interactively §7 Delve

2. Reading a Panic

Installs
51
GitHub Stars
71
First Seen
Jul 14, 2026
go-troubleshooting — eduardo-sl/go-agent-skills