| name | debug |
| description | Systematic debugging with structured reproduction and root cause analysis. |
| last_updated | Sat Dec 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time) |
Debug Skill
Overview
Don't guess; verify. This skill guides you through the systematic process of identifying, reproducing, and fixing bugs.
When To Use
- Users report a bug
- You encounter an unexpected error
- Tests are failing inexplicably
Instrumentation
# Log usage when using this skill
./scripts/log-skill.sh "debug" "manual" "$$"
What do you want to do?
- Reproduce an issue →
workflows/reproduce-issue.md - Find Root Cause →
workflows/root-cause-analysis.md - Create Bug Report →
templates/bug-report.template.md - Research Error Messages →
references/common-errors.md
The Golden Rule of Debugging
"If you haven't reproduced it, you haven't fixed it."
Always implement a reproduction case (test or script) BEFORE attempting a fix. Highly recommended to use the template at docs/templates/repro-script-template.sh and store artifacts in scripts/repro/.
[!NOTE] No top-level
debug/folder exists. Useskills/debug/for guidance andscripts/repro/for artifacts.