problem-analysis

Identifies root causes of problems via a gate-hypothesize-investigate-formulate-output workflow.

1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/akiselev/qt-llm-template --skill problem-analysis-akiselev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: problem-analysis
Source: https://github.com/akiselev/qt-llm-template/tree/main/.claude/skills/problem-analysis
Command: npx skills add https://github.com/akiselev/qt-llm-template --skill problem-analysis-akiselev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Root cause identification of problems by analyzing symptoms and signals to determine underlying causes, not solutions.

Core Features & Use Cases

  • Phase-driven analysis: Gate, Hypothesize, Investigate, Formulate, Output with a script orchestrating iteration.
  • Evidence-based reasoning: Collects and synthesizes signals, logs decisions, and provides a structured root-cause report.
  • Use Case: When a bug or incident occurs, the skill helps surface the most plausible root cause and supporting evidence.

Quick Start

Describe the observed problem and let the script start the guided 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 perform a root-cause analysis for a software bug or system failure?

To perform root-cause analysis for a software bug, you describe the observed problem to trigger a guided investigation that identifies underlying factors. The script orchestrates a structured workflow to synthesize signals and report the most plausible cause.

What is the best way to investigate user-reported incidents and find the underlying cause?

Investigating user-reported incidents requires evidence-based reasoning to collect and synthesize signals. A structured gate-hypothesize-investigate workflow logs decisions and formulates a root-cause report rather than providing immediate solutions.

How does the hypothesize-investigate workflow work for debugging complex problems?

The debugging workflow operates through a script-driven orchestration with a five-iteration cap. It progresses through Gate, Hypothesize, Investigate, Formulate, and Output phases to systematically narrow down root causes.

Can I use script-driven automation to analyze symptoms and identify root causes without writing custom logic?

Yes, script-driven automation analyzes symptoms and identifies root causes without requiring custom logic. You simply describe the observed problem, and the built-in script orchestrates the investigation phases automatically.

Does root-cause analysis provide solutions to fix software bugs and system failures?

Root-cause analysis does not provide solutions to fix software bugs or system failures. It strictly focuses on identifying the underlying causes and explaining supporting evidence, deliberately leaving solution implementation to other processes.

What are the limitations of using a five-iteration cap for incident investigation?

A five-iteration cap limits incident investigation to five script-driven cycles through the hypothesize and investigate phases. This constraint prevents infinite loops but means highly complex issues may require manual intervention if the root cause is not found within the limit.