Individual skill
debug
Comprehensive debugging methodology for finding and fixing bugs (formerly debugging). This skill should be used when debugging code, investigating errors, troubleshooting issues, performing root cause analysis, or responding to incidents. Covers systematic reproduction, hypothesis-driven investigation, and root cause analysis techniques. Use when encountering exceptions, stack traces, crashes, segfaults, undefined behavior, or when bug reports need investigation.
skills/.curated/debug/SKILL.md
Source commit cf93c57cac89d6fc3e4194686000411567f5caf3
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 222
- Repository last updated
- Aug 15, 2026
- License
- MIT
Observed agent integration: codex
- testing Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
AGENTS.mddoc · 11,766 bytesREADME.mddoc · 5,858 bytesSKILL.mdcore · 5,886 bytesassets/templates/_template.mddoc · 594 bytesmetadata.jsonasset · 1,074 bytesreferences/_sections.mddoc · 2,421 bytesreferences/anti-blame-tool.mddoc · 2,596 bytesreferences/anti-debug-fatigue.mddoc · 2,554 bytesreferences/anti-quick-patch.mddoc · 2,888 bytesreferences/anti-shotgun-debugging.mddoc · 2,494 bytesreferences/anti-tunnel-vision.mddoc · 2,461 bytesreferences/hypo-binary-search.mddoc · 2,800 bytesreferences/hypo-one-change-at-time.mddoc · 2,759 bytesreferences/hypo-rubber-duck.mddoc · 2,601 bytesreferences/hypo-rule-out-obvious.mddoc · 2,254 bytesreferences/hypo-scientific-method.mddoc · 2,609 bytesreferences/hypo-where-not-what.mddoc · 2,737 bytesreferences/obs-breakpoint-strategy.mddoc · 2,567 bytesreferences/obs-log-inputs-outputs.mddoc · 2,743 bytesreferences/obs-stack-trace-reading.mddoc · 2,838 bytesreferences/obs-strategic-logging.mddoc · 2,905 bytesreferences/obs-trace-data-flow.mddoc · 2,553 bytesreferences/obs-watch-expressions.mddoc · 2,569 bytesreferences/pattern-async-await-errors.mddoc · 2,530 bytesreferences/pattern-memory-leak.mddoc · 2,261 bytesreferences/pattern-null-pointer.mddoc · 1,805 bytesreferences/pattern-off-by-one.mddoc · 1,792 bytesreferences/pattern-race-condition.mddoc · 1,710 bytesreferences/pattern-timezone-issues.mddoc · 2,155 bytesreferences/pattern-type-coercion.mddoc · 2,048 bytesreferences/prev-defensive-coding.mddoc · 3,271 bytesreferences/prev-document-solution.mddoc · 2,515 bytesreferences/prev-improve-error-messages.mddoc · 2,870 bytesreferences/prev-postmortem.mddoc · 2,890 bytesreferences/prob-document-symptoms.mddoc · 1,993 bytesreferences/prob-minimal-reproduction.mddoc · 2,210 bytesreferences/prob-recent-changes.mddoc · 2,121 bytesreferences/prob-reproduce-before-debug.mddoc · 1,946 bytesreferences/prob-separate-symptoms-causes.mddoc · 2,354 bytesreferences/prob-state-expected-actual.mddoc · 2,351 bytesreferences/rca-examine-boundaries.mddoc · 4,494 bytesreferences/rca-fault-propagation.mddoc · 2,929 bytesreferences/rca-five-whys.mddoc · 2,244 bytesreferences/rca-last-known-good.mddoc · 2,381 bytesreferences/rca-question-assumptions.mddoc · 2,532 bytesreferences/tool-call-stack-navigation.mddoc · 2,774 bytesreferences/tool-conditional-breakpoints.mddoc · 2,324 bytesreferences/tool-exception-breakpoints.mddoc · 2,386 bytesreferences/tool-logpoints.mddoc · 2,464 bytesreferences/tool-memory-inspection.mddoc · 2,466 bytesreferences/tool-step-commands.mddoc · 2,709 bytesreferences/triage-duplicate-detection.mddoc · 1,813 bytesreferences/triage-quick-wins-first.mddoc · 1,734 bytesreferences/triage-reproducibility-matters.mddoc · 2,008 bytesreferences/triage-severity-vs-priority.mddoc · 1,812 bytesreferences/triage-user-impact-assessment.mddoc · 1,878 bytesreferences/verify-add-test.mddoc · 2,858 bytesreferences/verify-regression-check.mddoc · 2,421 bytesreferences/verify-reproduce-fix.mddoc · 2,040 bytesreferences/verify-understand-why-fix-works.mddoc · 2,461 bytes
Read excerpt
# 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.
## When to Apply
Reference these guidelines when:
- Investigating a bug or unexpected behavior
- Debugging code during development
- Code produces wrong results or crashes
- Performance issues need root cause analysis
- Triaging incoming bug reports and prioritizing fixes
- Conducting root cause analysis for incidents
- Reviewing debugging approaches or code for common bug patterns