diagnose

Diagnose bugs by gathering symptoms, testing hypotheses, and reporting findings.

6|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/opmau/claude-code-framework --skill diagnose-opmau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/opmau/claude-code-framework/tree/main/templates/.claude/skills/diagnose
Command: npx skills add https://github.com/opmau/claude-code-framework --skill diagnose-opmau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigates bugs using a structured differential diagnosis approach to avoid guesswork and premature fixes.

Core Features & Use Cases

  • Structured evidence gathering and hypothesis generation
  • Parallel investigation of multiple causes with explicit verdicts
  • Evidence-based reporting without applying fixes

Quick Start

Begin by gathering the symptom description from the user and follow the steps to collect evidence, form hypotheses, test each, and report findings.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I structure a debugging investigation to avoid guesswork?

Structured debugging uses differential diagnosis to avoid guesswork by gathering symptoms, collecting evidence, formulating hypotheses, testing them, and producing a structured diagnosis.

What is differential diagnosis in software debugging?

Differential diagnosis in software debugging is a structured method that generates multiple hypotheses for a symptom, tests each with collected evidence, and produces explicit verdicts.

Can I use this approach to investigate multiple bug hypotheses in parallel?

Yes, you can investigate multiple bug hypotheses in parallel. The approach formulates several causes, tests them with evidence, and reports explicit verdicts without applying fixes.

Does structured bug triage apply fixes automatically after finding the root cause?

No, structured bug triage does not apply fixes automatically. It focuses entirely on evidence-based reporting, providing a structured diagnosis without modifying code.

What is the best way to triage bugs using evidence instead of guessing?

The best way to triage bugs with evidence is following a differential diagnosis workflow: gather symptoms, collect evidence, formulate hypotheses, test them, and report structured findings.

When should I use a structured diagnosis for bug triage?

You should use a structured diagnosis for bug triage when a symptom is described and multiple potential causes must be investigated and tested with evidence to avoid premature fixes.