Diagnose — Root Cause Analysis Before Fixes

Diagnoses bugs by guiding users through symptom identification, hypothesis testing, and minimal-solution planning.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Karl-Seryani/The-Order --skill diagnose-root-cause-analysis-before-fixes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Diagnose — Root Cause Analysis Before Fixes
Source: https://github.com/Karl-Seryani/The-Order/tree/main/.claude/skills/diagnose
Command: npx skills add https://github.com/Karl-Seryani/The-Order --skill diagnose-root-cause-analysis-before-fixes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enforces a structured diagnosis workflow to identify the root cause of issues before attempting any fixes, preventing wasted effort and incorrect solutions.

Core Features & Use Cases

  • Structured Evidence Gathering: Collects all relevant script information and user observations.
  • Root Cause Hypothesis Generation: Identifies and ranks potential causes with supporting evidence.
  • Minimal Fix Proposal: Suggests the smallest possible change to address the confirmed root cause.
  • Verification and Re-analysis: Ensures fixes are validated and guides re-diagnosis if necessary.
  • Use Case: When a bug is reported in the Unity editor, this skill will guide the user through gathering evidence, hypothesizing the cause, proposing a minimal fix, and verifying the solution.

Quick Start

When the user runs /diagnose, follow the structured process to identify the root cause of an issue.

Frequently Asked Questions about Diagnose — Root Cause Analysis Before Fixes

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

FAQPage Schema
How do I perform root cause analysis before fixing a software bug?

Root cause analysis before fixing a bug involves gathering evidence, generating hypotheses, proposing minimal fixes, and verifying the solution. This structured workflow prevents premature coding and ensures systematic problem-solving to avoid wasted effort on incorrect fixes.

What is the best way to troubleshoot a Unity editor bug systematically?

Troubleshooting a Unity editor bug systematically requires collecting relevant script information and user observations, ranking potential root causes by evidence, and validating the smallest possible fix. This prevents wasted effort by confirming the root cause before applying code changes.

Why should I gather evidence before proposing a minimal fix to a reported issue?

Gathering evidence before proposing a minimal fix ensures you address the confirmed root cause rather than symptoms. This structured diagnosis workflow validates hypotheses with collected script data, preventing premature coding and avoiding incorrect solutions that waste debugging effort.

How do I verify a bug fix and re-analyze the issue if the solution fails?

To verify a bug fix and re-analyze if necessary, validate the minimal change against the confirmed root cause. If the fix fails, the structured diagnosis workflow guides you through re-gathering evidence and generating new hypotheses to identify the actual underlying issue.

Can I use a structured debugging workflow for issues outside of Unity editor scripts?

A structured debugging workflow applies to any software issue requiring systematic problem-solving. While the use case mentions Unity editor scripts, the evidence gathering, hypothesis generation, minimal fix proposal, and verification steps are platform-agnostic debugging techniques.