skills.rest
anexpn
anexpnCOMMUNITY
Explore all skills by this author →
GitHub

systematic-debugging

Diagnose software issues using a four-phase root-cause debugging framework.

1|Updated Oct 24, 2025
Search Tags:#debugging#methodology#problem solving#troubleshooting#software development#root cause analysis#error resolution
One-click install
npx skills add https://github.com/anexpn/claude-plugins --skill systematic-debugging-anexpn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/anexpn/claude-plugins/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/anexpn/claude-plugins --skill systematic-debugging-anexpn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the common pitfall of fixing symptoms rather than root causes, which leads to recurring bugs and wasted development time. It provides a disciplined, phase-based approach to debugging, ensuring thorough investigation and lasting solutions.

Core Features & Use Cases

  • Four-Phase Framework: Guides you through Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation Rules.
  • Root Cause Focus: Enforces a core principle to always find the root cause, preventing superficial fixes and workarounds.
  • Anti-Pattern Avoidance: Identifies and helps you avoid common debugging mistakes like "shotgun debugging" or "symptom treatment."
  • Use Case: When an unexpected error occurs in production, use this Skill to methodically investigate, reproduce, and resolve the issue, ensuring a robust fix.

Quick Start

Use this skill when you encounter any technical issue or error. Simply invoke the skill and describe the problem: "I'm encountering an error when X happens, can you help me debug it systematically?" The skill will then guide you through the four-phase process, prompting you for information and actions at each step.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug software issues systematically instead of fixing symptoms?▼

Systematic debugging uses a four-phase framework—Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation Rules—to identify and fix the underlying cause rather than surface symptoms. This prevents recurring bugs and wasted development time.

What's the best way to find the root cause of an error or bug?▼

Root cause analysis requires reproducibility, structured investigation of error patterns, hypothesis testing against those patterns, and minimal incremental fixes. The methodology guides you through error intake, change management, and validation to ensure lasting solutions.

How do I avoid common debugging mistakes like shotgun debugging?▼

Anti-pattern avoidance identifies common pitfalls such as symptom treatment and scattered troubleshooting. The four-phase framework enforces disciplined investigation and hypothesis validation, replacing trial-and-error with methodical problem-solving.

Can I use this debugging methodology for production errors and test failures?▼

Yes. The structured root-cause debugging methodology applies to technical problems, errors, test failures, unexpected behavior, performance problems, and system failures across codebases and environments.

What should I do when an unexpected error occurs in production?▼

Invoke the four-phase framework: investigate the error intake and reproducibility, analyze error patterns, test hypotheses against those patterns, and implement minimal fixes. This ensures robust, lasting resolution rather than temporary workarounds.

Related Skills

Explore More Software Engineering Skills→
thesaifalitaithesaifalitai
8

debugging-wizard

Diagnose and isolate software issue root causes through structured debugging workflows.

Community
Advanced
sdcorejssdcorejs
2

sdcorejs-repair-loop

Verify, fix, and re-verify review findings until Critical and Important items resolve.

Community
Advanced
nguyenthienthanhnguyenthienthanh
24

debugging

Diagnose defects through a four-phase root-cause debugging framework.

Community
Advanced
Dianshu-LiaoDianshu-Liao
2

debugging-strategies

Guide systematic debugging through reproduction, evidence gathering, hypothesis formation, and verification.

Community
Intermediate