failure-diagnosis

Diagnose software failures by separating symptom, trigger, and root cause.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill failure-diagnosis-machenjie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: failure-diagnosis
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/failure-diagnosis
Command: npx skills add https://github.com/machenjie/rd-skills --skill failure-diagnosis-machenjie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose failures by organizing evidence into a clear chain from symptom and trigger to root cause, with falsifiable hypotheses, minimal corrective action, and measurable prevention.

Core Features & Use Cases

  • Evidence-first diagnosis: separates symptom, trigger, root cause, and contributing factors to avoid trigger-only conclusions.
  • Hypothesis validation discipline: requires predictions plus confirming and refuting evidence for every hypothesis.
  • Reproduction or documented infeasibility: treats diagnosis as complete only when the failure can be reproduced or an evidence chain proves why it cannot.
  • Incident response and post-mortem rigor: enforces explicit incident roles, severity handling, and verifiable CAPA-style action items.

Quick Start

Use the failure-diagnosis skill when you have a production incident or failing test and you need a structured, evidence-driven diagnosis that ends with a minimal fix and verifiable prevention.

Frequently Asked Questions about failure-diagnosis

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

FAQPage Schema
How do I find the root cause of a production incident instead of just fixing the trigger?

Root cause analysis for software failures requires separating symptoms and triggers from the actual cause through evidence-first reasoning. This discipline validates falsifiable hypotheses with confirming and refuting evidence to prevent trigger-only conclusions.

What is the best way to structure a postmortem after a CI/CD failure or performance regression?

Structuring a postmortem requires separating root cause and contributing factors, then enforcing explicit incident roles and severity handling. This yields verifiable CAPA-style action items for measurable prevention and documented reproduction infeasibility.

Can I use hypothesis validation to debug data anomalies and concurrency issues?

Yes, you can debug data anomalies and concurrency issues using hypothesis validation. This requires formulating falsifiable predictions and gathering both confirming and refuting evidence to rigorously validate or eliminate each diagnostic hypothesis.

When do I need change-failure correlation for diagnosing software failures?

You need change-failure correlation when diagnosing software failures to link observable evidence with recent system modifications. This separates triggers from root causes when diagnosing production incidents, performance regressions, or third-party integration problems.

What are the completion criteria for an incident diagnosis when reproduction is not possible?

When reproduction is not possible, incident diagnosis completion criteria require an evidence chain proving infeasibility. The diagnosis must conclude with specific, verifiable postmortem and prevention action items to ensure measurable corrective outcomes.