Debug

This is a systematic debugging framework with 54 rules organized into 10 categories, from problem definition through root cause analysis to prevention. It covers the fundamentals like reproducing bugs and binary search localization alongside practical patterns for null pointers, race conditions, and async errors. The structure is solid, pulling from Andreas Zeller's research and academic curricula. Use it when you're stuck debugging or want to avoid shotgun debugging and tunnel vision. The hypothesis-driven approach and tool mastery sections are the strongest parts. It won't magically fix your bugs, but it gives you a methodical process when you're deep in a gnarly issue and need to slow down and think clearly.

skills.sh installs: 444
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill debug --agent claude-code

Installs into .claude/skills of the current project.

Files

dot-skills Debugging Best Practices

Comprehensive debugging methodology guide for software engineers, containing 54 rules across 10 categories prioritized by impact. Based on research from Andreas Zeller's "Why Programs Fail" and academic debugging curricula.