askill
root-cause-tracing

root-cause-tracingSafety 95Repository

Systematically trace bugs and issues to their root cause using debugging techniques and analysis methods

1 stars
1.2k downloads
Updated 1/16/2026

Package Files

Loading files...
SKILL.md

Root Cause Tracing Skill

Systematically identify root causes of bugs and system failures.

When to Use

  • Bug investigation
  • Production incidents
  • Performance issues
  • System failures

Analysis Frameworks

  1. 5 Whys: Ask "why?" repeatedly
  2. Fishbone Diagram: Categorize causes
  3. Fault Tree Analysis: Logic tree of failures
  4. Timeline Analysis: Chronological events

Debugging Process

  1. Reproduce: Create minimal reproduction
  2. Isolate: Narrow down location
  3. Trace: Follow execution path
  4. Hypothesis: Form theory
  5. Test: Verify theory
  6. Fix: Implement solution
  7. Verify: Confirm fix works

Tools

  • Debuggers (gdb, lldb, pdb)
  • Logging and tracing
  • Profilers
  • Stack traces
  • Network analyzers

5 Whys Example

Problem: Website is slow
Why? Database queries are slow
Why? No indexes on frequently queried columns
Why? Database schema not optimized
Why? Initial design didn't account for scale
Why? No performance testing during development
Root Cause: Lack of performance testing

Best Practices

  • Document investigation steps
  • Don't jump to conclusions
  • Test hypotheses systematically
  • Consider multiple causes
  • Implement preventive measures

Resources

Install

Download ZIP
Requires askill CLI v1.0+

AI Quality Score

82/100Analyzed 2/25/2026

Well-structured debugging skill with clear When to Use section, multiple analysis frameworks (5 Whys, Fishbone, Fault Tree), and a 7-step debugging process. Includes practical 5 Whys example, tool list, best practices, and external resources. Tags improve discoverability. Located in dedicated skills folder. Content is actionable and broadly applicable across languages and domains, though could benefit from more specific tool commands or detailed examples.

95
82
75
80
78

Metadata

Licenseunknown
Version-
Updated1/16/2026
Publisherljchg12-hue

Tags

databaseobservabilitytesting