Skills
.Work. You
Rest

debug-root

Community

Diagnose stubborn bugs by tracing root causes.

Software Engineering#debugging#diagnosis#code-quality#root-cause#bug-tracking#phase-workflow#repeat-bug
Authorleessju
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps teams diagnose root causes when the same bug is fixed multiple times but the issue reoccurs, guiding a disciplined six-phase workflow instead of ad-hoc fixes.

Core Features & Use Cases

  • Freeze phase: inventory all prior changes without making new ones and infer why each attempt failed.
  • Trace phase: read code paths and data flows without executing the program to validate entry points and paths.
  • Diagnose phase: specify a concrete file/line-level root cause with supporting evidence.
  • Challenge phase: test counterfactuals and strengthen the diagnosis.
  • Fix phase: apply minimal, targeted changes only once.
  • Verify phase: explain why the fix resolves the symptom and cover edge cases. Use case: when a bug has been fixed multiple times but reappears, this skill provides a repeatable diagnosis and corrective workflow.

Quick Start

Describe the repeated-bug symptom, then drive through the six-phase workflow to isolate and fix the root cause.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debug-root
Download link: https://github.com/leessju/claude-skills/archive/main.zip#debug-root

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.