diagnose

Diagnose and fix bugs through a structured feedback loop.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/weside-ai/claude-code-plugin --skill diagnose-weside-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/weside-ai/claude-code-plugin/tree/main/we/skills/diagnose
Command: npx skills add https://github.com/weside-ai/claude-code-plugin --skill diagnose-weside-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a disciplined diagnosis loop for hard bugs and performance regressions, ensuring a systematic approach to identifying and resolving issues.

Core Features & Use Cases

  • Structured Diagnosis Loop: Offers a step-by-step process for reproducing, minimizing, hypothesizing, instrumenting, fixing, and regression-testing bugs.
  • Feedback Loop Construction: Assists in building a tight, deterministic, and fast feedback loop to quickly identify the cause of a bug.
  • Minimal Reproduction: Helps in creating a minimal reproducible scenario to narrow down the problem and simplify the hypothesis generation.
  • Hypothesis Testing: Guides the user in generating falsifiable hypotheses and testing them systematically.
  • Instrumentation and Logging: Provides guidance on effective debugging techniques, including targeted logging and performance measurement.
  • Regression Testing: Ensures that the fix is effective and the bug is resolved without introducing new issues.

Quick Start

Run the diagnose skill to start the bug diagnosis process.

Frequently Asked Questions about diagnose

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

FAQPage Schema
What is a structured approach to debugging and why do I need it for hard bugs?

A structured debugging approach systematically reproduces, minimizes, and hypothesizes issues to fix hard bugs. You need it to build a tight feedback loop, replacing guesswork with deterministic instrumentation and regression testing to resolve complex problems efficiently.

How do I diagnose a performance regression using a systematic debugging process?

To diagnose a performance regression, systematically construct a fast feedback loop, create a minimal reproduction scenario, and generate falsifiable hypotheses. Use targeted instrumentation and performance measurement to isolate the cause and verify the fix through regression testing.

How do I create a minimal reproduction scenario to narrow down a system bug?

Create a minimal reproduction scenario by systematically stripping away irrelevant variables while maintaining the bug's trigger. This narrows down the problem space, simplifies hypothesis generation, and constructs a tight, deterministic feedback loop for faster bug diagnosis.

What is the best way to build a feedback loop for resolving complex code issues?

The best way to build a feedback loop for complex code issues is to make it tight, deterministic, and fast. This requires deep system understanding, targeted logging, and systematic hypothesis testing to quickly identify and confirm the root cause.

Does systematic bug diagnosis require specific instrumentation or logging frameworks?

Systematic bug diagnosis does not require specific frameworks, but it heavily relies on effective debugging techniques. You must implement targeted logging and performance measurement within your environment to instrument the system and test hypotheses systematically.

When should I use a structured diagnosis loop instead of standard troubleshooting?

Use a structured diagnosis loop instead of standard troubleshooting when facing hard bugs or performance regressions that resist quick fixes. It is necessary when you need to build a tight feedback loop and generate falsifiable hypotheses to isolate complex system failures.