diagnose

Guide developers through structured diagnosis of hard bugs and performance regressions.

1|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/JuanMS20/bundles-skills --skill diagnose-juanms20
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/JuanMS20/bundles-skills/tree/main/skills/matt-pocock/diagnose
Command: npx skills add https://github.com/JuanMS20/bundles-skills --skill diagnose-juanms20

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill assists in the diagnosis of hard bugs and performance regressions, providing a disciplined loop for reproducing, hypothesizing, and fixing issues efficiently.

Core Features & Use Cases

  • Disciplined Diagnosis Loop: Guides through a structured process of reproducing bugs, formulating hypotheses, and applying fixes.
  • Reproduction and Replication: Offers methods to create reliable feedback loops for consistent bug replication.
  • Hypothesis Testing: Encourages generating falsifiable hypotheses and systematically testing them.
  • Instrumentation: Utilizes various debugging tools and techniques for precise diagnosis.
  • Regression Testing: Ensures fixes do not introduce new issues.

Quick Start

Execute the diagnose skill to begin debugging a reported issue.

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 and performance regressions systematically?

Debugging hard bugs and performance regressions requires a structured approach: construct a reliable feedback loop for reproduction, generate falsifiable hypotheses, test them systematically using instrumentation, and verify the applied fix.

What is the best way to reproduce a bug for consistent debugging?

Reproducing a bug reliably requires constructing a controlled feedback loop that consistently triggers the issue. This replication step is essential before generating falsifiable hypotheses and applying fixes.

Do I need prior knowledge of debugging tools to use a structured diagnosis loop?

Yes, effective debugging through a structured diagnosis loop requires existing knowledge of debugging tools and practices. You must understand how to apply instrumentation and test hypotheses to diagnose hard bugs and performance regressions.

How does hypothesis testing work when diagnosing performance regressions?

Hypothesis testing for performance regressions involves generating falsifiable statements about the root cause and systematically testing each one. This methodical approach prevents incorrect fixes and ensures the regression is accurately diagnosed.

How do I ensure my bug fix does not introduce new performance regressions?

To ensure your bug fix does not introduce new performance regressions, perform regression testing after applying the fix. This step verifies that the original hard bug is resolved without causing new issues or degrading system performance.