problem-analysis

Identifies root causes of software problems via a five-phase workflow script.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/marqus0004/LifeIsRoadBlocks --skill problem-analysis-marqus0004
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: problem-analysis
Source: https://github.com/marqus0004/LifeIsRoadBlocks/tree/main/skills/problem-analysis
Command: npx skills add https://github.com/marqus0004/LifeIsRoadBlocks --skill problem-analysis-marqus0004

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Root-cause identification for problems in software and operations, enabling teams to understand why an issue occurs before jumping to fixes.

Core Features & Use Cases

  • Systematically gates input to ensure a well-defined problem.
  • Generates and evaluates multiple hypotheses to avoid confirmation bias.
  • Provides a structured, actionable root-cause report for downstream remediation.

Quick Start

Invoke the Python script to start the root-cause investigation.

Frequently Asked Questions about problem-analysis

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

FAQPage Schema
How do I identify the root cause of a software bug or incident?

To identify the root cause of a software bug, you need a structured investigation that generates and evaluates multiple hypotheses to avoid confirmation bias. This approach systematically gates your input to ensure a well-defined problem before analysis.

What is the best way to investigate performance degradation during incident management?

The best way to investigate performance degradation is using a structured five-phase workflow: Gate, Hypothesize, Investigate, Formulate, and Output. This method ensures you evaluate multiple hypotheses rather than jumping directly to fixes.

How does a hypothesis-driven root cause analysis work for software systems?

Hypothesis-driven root cause analysis works by systematically generating and evaluating multiple potential causes for a system issue. It gates the initial input to define the problem clearly, then iterates through investigations to formulate a structured, actionable report.

Can I use this root cause analysis process for bug triage across different software systems?

Yes, you can use this root cause analysis process for bug triage across software systems. It applies broadly to incident investigations, bug triage, and performance degradations, managing the workflow with iteration control and readiness checks.

What are the limitations of using a structured root cause investigation workflow?

A structured root cause investigation requires a well-defined problem to pass the initial gating phase. If the input issue is vague or lacks context, the workflow cannot effectively generate hypotheses or formulate an actionable downstream remediation report.

Why should I generate multiple hypotheses during a debugging investigation?

Generating multiple hypotheses during a debugging investigation prevents confirmation bias. By systematically evaluating various potential root causes before formulating an output, you ensure a more reliable diagnosis for downstream remediation instead of jumping to premature fixes.