Debugging

This is a framework for actually finding root causes instead of slapping Band-Aids on symptoms. It enforces an iron law: no fixes without investigation first, and no claiming completion without verification evidence. The core insight is real: systematic debugging averages 15-30 minutes while guess-and-check thrashing burns 2-3 hours. Four sub-skills cover the full cycle from tracing bugs backward through the call stack to defense-in-depth validation at every layer. The quick dispatch table is handy for knowing which approach fits your current fire. If you've ever "fixed" a bug three times because you kept treating symptoms, this will feel like finally putting on glasses.

skills.sh installs: 575
GitHub stars: 2.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mrgoonie/claudekit-skills --skill debugging --agent claude-code

Installs into .claude/skills of the current project.

Files

Debugging Skills

A collection of systematic debugging methodologies that ensure thorough investigation before attempting fixes.

Available Sub-Skills

Systematic Debugging

Location: systematic-debugging/SKILL.md

Four-phase debugging framework: Root Cause Investigation → Pattern Analysis → Hypothesis Testing → Implementation. The iron law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.

Root Cause Tracing

Location: root-cause-tracing/SKILL.md

Trace bugs backward through the call stack to find the original trigger. Don't fix symptoms - find where invalid data originated and fix at the source.

Defense-in-Depth Validation

Location: defense-in-depth/SKILL.md

Validate at every layer data passes through to make bugs structurally impossible. Four layers: Entry Point → Business Logic → Environment Guards → Debug Instrumentation.