code-showcase-systematic-debugging
Four-phase debugging methodology with root cause analysis. Use when investigating bugs, fixing test failures, or troubleshooting unexpected behavior. Emphasizes NO FIXES WITHOUT ROOT CAUSE FIRST.
npx skills add sickn33/agentic-awesome-skills --skill code-showcase-systematic-debugging --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Systematic Debugging ## When to Use Use this skill when you need four-phase debugging methodology with root cause analysis. Use when investigating bugs, fixing test failures, or troubleshooting unexpected behavior. Emphasizes NO FIXES WITHOUT ROOT CAUSE FIRST. ## Core Principle **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.** Never apply symptom-focused patches that mask underlying problems. Understand WHY something fails before attempting to fix it. ## The Four-Phase Framework ### Phase 1: Root Cause Investigation Before touching any code: 1. **Read error messages thoroughly** - Every word matters 2. **Reproduce the issue consistently** - If you can't reproduce it, you can't verify a fix 3. **Examine recent changes** - What changed before this started failing? 4. **Gather diagnostic evidence** - Logs, stack traces, state dumps 5. **Trace data flow** - Follow the call chain to find where bad values originate **Root Cause Tracing Technique:** ``` 1. Observe the symptom - Where does the error manifest? 2. Find immediate cause - Which code directly produces the error? 3. Ask "What called this?" - Map the call chain upward 4. Keep tracing up - Follow invalid data backward through
- When to Use
- Core Principle
- The Four-Phase Framework
- Phase 1: Root Cause Investigation
- Phase 2: Pattern Analysis
- Phase 3: Hypothesis and Testing
- Phase 4: Implementation
- Red Flags - Process Violations
- Warning Signs of Deeper Problems
- Common Debugging Scenarios
- Test Failures
- Runtime Errors
- "It worked before"
- Intermittent Failures
What does the code-showcase-systematic-debugging skill do?
Four-phase debugging methodology with root cause analysis. Use when investigating bugs, fixing test failures, or troubleshooting unexpected behavior. Emphasizes NO FIXES WITHOUT ROOT CAUSE FIRST.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill code-showcase-systematic-debugging --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.