diagnose

Diagnose root causes of bugs and performance regressions with hypotheses and instrumentation.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Rayzerrek/dotfiles --skill diagnose-rayzerrek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Rayzerrek/dotfiles/tree/main/.agents/skills/diagnose
Command: npx skills add https://github.com/Rayzerrek/dotfiles --skill diagnose-rayzerrek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you systematically find the root cause of hard bugs, flaky failures, and performance regressions when a quick glance at the code is not enough.

Core Features & Use Cases

  • Reproduce and minimize the issue until the failure is deterministic and easy to reason about.
  • Form ranked, falsifiable hypotheses so each next step tests a specific prediction instead of guessing.
  • Instrument and verify with targeted probes, then lock the fix in with a regression test when the right seam exists.
  • Use case: A build is intermittently failing, a UI action sometimes throws, or a release has become slower and you need a structured way to isolate the cause.

Quick Start

Use the diagnose skill to reproduce the failure, narrow it to a minimal loop, and fix it with a regression test.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I find the root cause of flaky failures and performance regressions?

A disciplined debugging loop isolates hard bugs by reproducing and minimizing the failure until it is deterministic, then forming ranked falsifiable hypotheses to test specific predictions instead of guessing.

What is the best way to debug intermittent build failures or slow code paths?

Debugging intermittent build failures requires minimizing the issue until the failure is deterministic, instrumenting the code with targeted probes to gather a fast feedback signal, and locking the fix in with a regression test.

How do you write falsifiable hypotheses for bug hunting?

Writing falsifiable hypotheses for bug hunting involves ranking each potential cause so that every next step tests a specific prediction, ensuring you systematically isolate the root cause rather than guessing randomly.

Can I use a disciplined debugging loop for reproducible failures in my codebase?

Yes, a disciplined debugging loop works for reproducible failures by requiring a fast feedback signal, targeted instrumentation to verify probes, and a regression test placed at the correct seam to lock in the fix.

When should I add targeted instrumentation during performance debugging?

You should add targeted instrumentation during performance debugging after forming ranked falsifiable hypotheses, using the probes to verify specific predictions and establish a fast feedback signal before writing a regression test.

What are the limitations of using a structured debugging loop for bug hunting?

A structured debugging loop for bug hunting requires a fast feedback signal and a reproducible failure state; it may not suit non-reproducible issues or codebases lacking a correct seam to place a regression test.