skills.rest
JackSmack1971
JackSmack1971COMMUNITY
Explore all skills by this author →
GitHub

debug-root-cause-analysis

Guide structured root-cause debugging through observe, reproduce, hypothesize, test, fix, verify, and prevent phases.

Updated Dec 31, 2025
Search Tags:#debugging#logs#verification#root-cause#reproduction
One-click install
npx skills add https://github.com/JackSmack1971/claude-code-learning-flywheel --skill debug-root-cause-analysis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-root-cause-analysis
Source: https://github.com/JackSmack1971/claude-code-learning-flywheel/tree/main/.claude/skills/debug-root-cause-analysis
Command: npx skills add https://github.com/JackSmack1971/claude-code-learning-flywheel --skill debug-root-cause-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents shotgun debugging by guiding a structured process: observe, reproduce, hypothesize, test, fix, verify, and prevent.

Core Features & Use Cases

  • Phase-based debugging and zero-context scripts for evidence gathering
  • Logical steps to reproduce and test hypotheses
  • Use Case: Reduce time to fix bugs by following the root-cause flow

Quick Start

Run the analyze_logs.py to parse logs; reproduce the bug with a minimal test; commit minimal fix and regression test.