Diagnose

Reproduce software bugs and generate ranked falsifiable hypotheses.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/anderson-joyle/claude-a-team --skill diagnose-anderson-joyle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Diagnose
Source: https://github.com/anderson-joyle/claude-a-team/tree/main/skills/diagnose
Command: npx skills add https://github.com/anderson-joyle/claude-a-team --skill diagnose-anderson-joyle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you turn an unclear bug report into a deterministic debugging starting point by building a feedback loop, reproducing the failure, and generating falsifiable hypotheses before any implementation changes.

Core Features & Use Cases

  • Diagnosis Probe feedback loop: Selects an appropriate repro strategy (tests, curl/HTTP, CLI snapshots, headless browser, trace replay, minimal harness, fuzzing, bisecting, differential runs, or HITL script) and drives it until you have a reliable signal.
  • Reproduction confirmation gate: Verifies that the loop reproduces the user-described failure, is repeatable (or debuggable at a high enough rate for flaky bugs), and captures the exact symptom needed for later verification.
  • Ranked falsifiable hypotheses: Produces 3–5 prioritized, testable cause-and-effect statements with explicit predictions to guide Phase 2.

Quick Start

Use this skill when you have a bug (work_type set to bug) and ask an AI to produce a reproducible diagnosis probe and a set of ranked, falsifiable hypotheses based on the evidence it gathered.

Frequently Asked Questions about Diagnose

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

FAQPage Schema
How do I reproduce a software bug from an unclear report before writing code?▼

To reproduce a software bug, you can build a deterministic feedback loop using tests, curl/HTTP, CLI snapshots, headless browsers, or trace replay until you get a reliable, repeatable signal confirming the reported failure.

What is a falsifiable hypothesis in debugging and how does it help diagnose bugs?▼

A falsifiable hypothesis in debugging is a prioritized, testable cause-and-effect statement with explicit predictions. It guides your diagnosis by verifying or eliminating suspected causes through probe-gated execution before implementation.

How do I create a test harness for reproducing flaky bugs that are not consistently repeatable?▼

You create a test harness by selecting a repro strategy like fuzzing or bisecting and driving it until the loop is debuggable at a high enough rate for flaky bugs, capturing the exact symptom needed for later verification.

What's the best way to diagnose software bugs without directly modifying production code?▼

The best way to diagnose bugs without production changes is to create a diagnosis probe using available test, API, UI, trace, or harness techniques to gather evidence and generate ranked hypotheses for subsequent execution.

Can I use trace replay and differential runs to verify a bug reproduction?▼

Yes, you can use trace replay and differential runs as repro strategies to drive a deterministic feedback loop, verifying that the loop reproduces the user-described failure and captures the exact symptom for verification.

When should I not use a diagnosis probe approach for debugging?▼

You should not use a diagnosis probe approach if your work type is not a bug, or if you cannot establish a repeatable feedback loop, as the method requires symptom capture and repeatability checks to generate falsifiable hypotheses.