One-click install
npx skills add https://github.com/pekral/pekral.cz --skill analyze-problem-pekral
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-problem
Source: https://github.com/pekral/pekral.cz/tree/main/.claude/skills/analyze-problem
Command: npx skills add https://github.com/pekral/pekral.cz --skill analyze-problem-pekral

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you break down a complex issue into verified facts, competing hypotheses, and a most likely root cause so you can act with confidence and avoid premature solutions.

Core Features & Use Cases

  • Structured problem analysis: Walks through a fixed 10-step framework from context extraction to a final non-technical recommendation.
  • Evidence-first reasoning: Separates verified facts from assumptions, explicitly states uncertainty, and avoids confirmation bias.
  • Safety-focused change planning: Recommends the smallest safe solution and includes alternatives rejected plus a verification plan.

Quick Start

Use the analyze-problem skill to produce a complete root-cause analysis report from your bug report and available context using the provided analysis-report template.

Frequently Asked Questions about analyze-problem

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

FAQPage Schema
How do I perform structured debugging to find a software incident root cause?

Structured debugging identifies a software incident root cause by separating verified facts from assumptions and testing competing hypotheses. A strict 10-step framework extracts context, evaluates evidence, and recommends the smallest safe fix with a verification plan.

What is evidence-based problem analysis for complex regressions?

Evidence-based problem analysis for complex regressions avoids premature fixes and confirmation bias by explicitly stating uncertainty. It generates a report distinguishing facts from hypotheses to pinpoint the most likely root cause before proposing changes.

How do I do incident triage when multiple hypotheses exist for a bug?

Incident triage with multiple hypotheses uses a fixed 10-step framework to evaluate competing explanations against available context. It separates facts from assumptions, handles uncertainty explicitly, and outputs a structured analysis report.

What's the best way to plan safe fixes after technical risk assessment?

Planning safe fixes after technical risk assessment involves recommending the smallest viable solution while listing rejected alternatives. It requires generating a verification plan to ensure the proposed change resolves the root cause safely.

When should I not use hypothesis testing for software issue triage?

Avoid hypothesis testing for software issue triage when the problem is trivial or the root cause is already visually obvious. It is designed for complex incidents and regressions requiring strict evidence evaluation and uncertainty handling.