diagnose

Diagnose bugs and performance regressions with reproducible feedback loops.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/mpsuesser/workspace --skill diagnose-mpsuesser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/mpsuesser/workspace/tree/main/dotconfig/pi/agent/skills/.deprecated/diagnose
Command: npx skills add https://github.com/mpsuesser/workspace --skill diagnose-mpsuesser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you systematically diagnose hard bugs and performance regressions by turning vague symptoms into a reproducible, testable cause.

Core Features & Use Cases

  • Build a strong feedback loop that produces a fast, deterministic pass/fail signal for the suspected issue (tests, HTTP/CLI scripts, browser automation, trace replay, or harnesses).
  • Reproduce before guessing to ensure you’re chasing the exact failure mode the user reported, not a nearby one.
  • Hypothesise, instrument, fix, and regress-test using falsifiable predictions, targeted probing, and cleanup so the investigation leaves the codebase safer.

Quick Start

Ask the AI to diagnose a failing bug you’re seeing by first constructing a tight feedback loop and then running the loop until the symptom reproduces reliably.

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 a hard bug or performance regression?

To find the root cause of a hard bug, you must first build a deterministic feedback loop that reliably reproduces the exact failure mode. Then test ranked, falsifiable hypotheses using targeted instrumentation until you isolate the cause.

What is the best way to debug a failing test when I am just guessing at the cause?

The best way to debug a failing test without guessing is to adopt a reproduce-first workflow. Construct a tight pass/fail signal using scripts or harnesses, confirm the symptom, and then probe ranked hypotheses systematically.

How do I systematically diagnose a performance regression using instrumentation?

You diagnose a performance regression by building a fast feedback loop that captures the slowdown, formulating falsifiable predictions about the bottleneck, and adding targeted instrumentation to verify those specific hypotheses.

Can I use a reproduce-first workflow to fix thrown errors in HTTP or CLI scripts?

Yes, a reproduce-first workflow effectively fixes thrown errors in HTTP or CLI scripts by constructing deterministic test harnesses. This ensures you are chasing the exact reported failure before attempting a fix.

What should I do after fixing a bug to ensure the codebase stays safe?

After fixing a bug, you should write a regression test to lock in the fix and clean up any debug instrumentation artifacts. This disciplined loop leaves the codebase safer and confirms the root cause is resolved.

When should I use hypothesis testing instead of standard debugging for broken behavior?

Use hypothesis testing for broken behavior when you need root-cause certainty and face vague symptoms. It transforms guessing into falsifiable predictions, ensuring your instrumentation directly validates or eliminates suspected causes.