diagnose

Diagnose complex technical issues through reproduction, hypothesis testing, and regression testing.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/Kushal9889/claude-plugins --skill diagnose-kushal9889
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Kushal9889/claude-plugins/tree/main/mattpocock-skills/skills/engineering/diagnose
Command: npx skills add https://github.com/Kushal9889/claude-plugins --skill diagnose-kushal9889

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a disciplined diagnosis loop for hard bugs and performance regressions, enabling quick and effective resolution of technical issues.

Core Features & Use Cases

  • Structured Diagnosis Loop: A step-by-step approach to reproduce, hypothesize, instrument, and fix bugs.
  • Feedback Loop Construction: Focuses on building a fast, deterministic, and reproducible feedback loop for the bug.
  • Reproduction and Hypothesis Testing: Offers a methodical way to reproduce bugs and generate falsifiable hypotheses.
  • Instrumentation and Fixing: Utilizes targeted logs and debugging tools to isolate and resolve issues.
  • Regression Testing: Ensures that fixes do not introduce new bugs and maintains system integrity.
  • Use Case: When encountering a bug or performance regression, this Skill guides the user through a systematic process to identify and resolve the issue.

Quick Start

Use the diagnose skill to initiate a diagnosis loop for a reported bug or performance issue in your codebase.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I systematically diagnose a hard-to-find bug in my codebase?

To systematically diagnose a bug, use a structured approach that reproduces the issue, generates falsifiable hypotheses, applies targeted instrumentation, and runs regression testing to isolate and resolve the root cause.

What is a structured diagnosis loop for resolving performance regressions?

A structured diagnosis loop for performance regressions is a step-by-step methodology that builds a fast, deterministic, and reproducible feedback loop to methodically reproduce the issue and test hypotheses.

How can I build a deterministic feedback loop for codebase analysis and debugging?

You can build a deterministic feedback loop by creating a reproducible environment for the bug, applying targeted logs and debugging tools, and systematically testing hypotheses to quickly iterate on fixes.

Does resolving complex technical issues require a deep understanding of debugging tools?

Resolving complex technical issues systematically requires a deep understanding of the codebase and debugging tools to effectively instrument the code, isolate hard-to-find bugs, and verify performance regressions.

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

Ensure bug fixes do not introduce new regressions by implementing regression testing after isolating the issue, which maintains system integrity by verifying that the fix resolves the bug without causing new problems.