diagnose

Diagnose root causes of bugs and performance regressions with a structured loop.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/paialex/ai-skills-bank --skill diagnose-paialex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/paialex/ai-skills-bank/tree/main/mattpocock_skills/engineering/diagnose
Command: npx skills add https://github.com/paialex/ai-skills-bank --skill diagnose-paialex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Disciplined diagnosis loop for hard bugs and performance regressions that provides a structured, repeatable workflow to move from reproduction to hypothesis to instrumentation and fixes.

Core Features & Use Cases

  • Feedback-driven repro and minimization: establish a fast, deterministic signal to identify root causes.
  • Hypothesis-based debugging: generate and rank 3–5 plausible hypotheses before testing.
  • Instrument and verify fixes: add targeted instrumentation and regression tests to confirm the fix.

Quick Start

Run the diagnosis loop against a failing build to identify root cause and verify the fix.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I debug hard bugs when I cannot find the root cause?

Debugging hard bugs requires a disciplined diagnosis loop to move from reproduction to hypothesis to instrumentation and fixes. This structured workflow establishes a fast, deterministic feedback signal to pinpoint root causes.

What is the best way to diagnose flaky behavior and unexplained slowdowns in CI?

Diagnosing flaky behavior and performance regressions in CI requires a structured diagnostic loop applying explicit hypotheses and structured phases like reproduce, minimize, hypothesize, instrument, fix, and regression-test.

How do I reproduce and minimize a failing test to identify a root cause?

Reproducing and minimizing failing tests requires feedback-driven reproduction to establish a deterministic signal. This process isolates the exact conditions triggering the failure to guide targeted debugging.

Does bug-hunting with a diagnostic loop require a deterministic feedback signal?

Yes, bug-hunting with a diagnostic loop requires a deterministic feedback signal and explicit hypotheses. This feedback-driven approach ensures structured phases effectively guide debugging from reproduction to regression testing.