debug-investigator

Automate root-cause analysis with 5 Whys and RCA reports.

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/pierreribeiro/myclaudemd --skill debug-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-investigator
Source: https://github.com/pierreribeiro/myclaudemd/tree/main/skills/personas/debug-investigator
Command: npx skills add https://github.com/pierreribeiro/myclaudemd --skill debug-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides an Investigation Analyst persona to perform structured troubleshooting and root-cause analysis when complex issues arise, enabling consistent, methodical problem resolution.

Core Features & Use Cases

  • Structured problem-solving workflow (5 Whys, hypothesis testing)
  • Evidence collection and documentation (logs, timelines)
  • RCA artifacts and reports generation
  • Activation in production and learning contexts; supports TEA/ADHD processing style
  • Suitable for debugging software failures, data pipeline issues, and system incidents

Quick Start

To activate: send a message containing one of the activation keywords (debug, investigate, troubleshoot, analyze, diagnose, error, bug, root-cause, RCA, trace, inspect) and include observed symptoms or logs. The assistant will respond as Investigation Analyst and begin the Phase 1 symptom collection process.

Frequently Asked Questions about debug-investigator

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

FAQPage Schema
How do I perform root-cause analysis for a software bug using the 5 Whys method?

Root-cause analysis for a software bug is performed using a structured 5 Whys workflow and hypothesis testing. The process collects evidence from logs and diagnostic data to systematically identify the underlying cause of system failures.

What's the best way to investigate system incidents and generate RCA reports?

The best way to investigate system incidents is through structured troubleshooting that collects evidence and timelines, then generates RCA artifacts and reports. This methodical approach ensures consistent problem resolution across services.

Can I use hypothesis testing to debug data pipeline issues and data-quality problems?

Yes, you can use hypothesis testing to debug data pipeline issues and data-quality problems. The investigation workflow supports evidence collection and structured problem-solving for failures across services, including data pipelines.

How do I start troubleshooting when I observe error symptoms in my logs?

To start troubleshooting error symptoms in your logs, include the observed symptoms or logs in your initial prompt. The investigation begins with a Phase 1 symptom collection process to gather diagnostic data systematically.

Does structured debugging work for investigating incidents in production environments?

Yes, structured debugging works for investigating incidents in production environments. It is applicable for activation in production contexts and supports consistent, methodical problem resolution when complex issues arise.