diagnosing-bugs

Diagnose software bugs through a structured six-phase feedback loop.

63|9|Updated Jun 15, 2025
One-click install
npx skills add https://github.com/willdady/platypus --skill diagnosing-bugs-willdady
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnosing-bugs
Source: https://github.com/willdady/platypus/tree/main/.agents/skills/diagnosing-bugs
Command: npx skills add https://github.com/willdady/platypus --skill diagnosing-bugs-willdady

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the common issue of aimless debugging by enforcing a structured, evidence-based feedback loop that prevents premature hypothesis generation and ensures bugs are reproduced and verified systematically.

Core Features & Use Cases

  • Feedback Loop Construction: Provides a prioritized methodology for creating tight, deterministic reproduction signals (tests, scripts, or traces).
  • Minimization & Verification: Guides the user to shrink reproduction cases to their smallest load-bearing form and verify fixes against the original symptom.
  • Use Case: When a user reports a performance regression or a hard-to-reproduce crash, this skill forces the creation of a red-capable test case before any code changes are attempted, ensuring the fix is both correct and permanent.

Quick Start

Use the diagnosing-bugs skill to establish a tight feedback loop for the reported issue and guide the investigation through to a verified fix.

Frequently Asked Questions about diagnosing-bugs

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

FAQPage Schema
How do I systematically reproduce a hard-to-isolate software bug before attempting a fix?

To reproduce a software bug systematically, you need a structured feedback loop that creates deterministic reproduction signals like tests or scripts. This approach isolates the exact failure mode by enforcing evidence-based tracing before any code changes are attempted.

What is root cause analysis troubleshooting and when do I need a structured debugging framework?

Root cause analysis troubleshooting is an evidence-based methodology that prevents premature hypothesis generation during complex technical investigations. You need a structured debugging framework when dealing with hard-to-reproduce crashes or performance regressions requiring deterministic verification.

How do I debug a performance regression using a feedback loop?

Debugging a performance regression using a feedback loop requires establishing a deterministic test case that captures the original symptom. You then minimize this reproduction scenario to its smallest load-bearing form to isolate the failure mode and verify the fix.

Can I use shell scripts and test suites to isolate failure modes during troubleshooting?

Yes, you can use shell scripts and test suites to isolate failure modes during troubleshooting. Executing these tools provides deterministic reproduction signals that validate code changes and ensure your bug fixes are both correct and permanent.

What is the best way to minimize a test case for complex bug reproduction?

The best way to minimize a test case for bug reproduction is to systematically shrink the failure scenario to its smallest load-bearing form. This minimization process tightens the feedback loop, ensuring the isolated test directly validates the specific failure mode.

Why does aimless debugging fail to permanently resolve complex software bugs?

Aimless debugging fails to permanently resolve software bugs because it skips deterministic reproduction, allowing premature hypotheses to introduce unverified code changes. Without a structured feedback loop, the original symptom is rarely verified against the fix.