skills.rest
MarcoAntolini
MarcoAntoliniCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

diagnosing-bugs

Diagnose bugs and performance regressions through systematic hypothesis validation.

1|Updated May 14, 2026
Search Tags:#software development#root cause analysis#bug diagnosis#debugging process#performance regression
One-click install
npx skills add https://github.com/MarcoAntolini/cursor-sync --skill diagnosing-bugs-marcoantolini
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagnosing-bugs
Source: https://github.com/MarcoAntolini/cursor-sync/tree/main/agents/skills/diagnosing-bugs
Command: npx skills add https://github.com/MarcoAntolini/cursor-sync --skill diagnosing-bugs-marcoantolini

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured approach to diagnose complex bugs and performance regressions, enabling efficient root cause analysis and resolution.

Core Features & Use Cases

  • Diagnosis Loop: Offers a systematic method to build a tight feedback loop for identifying and confirming the presence of a bug.
  • Reproduction and Minimization: Assists in reproducing the bug with minimal input, focusing on the smallest scenario that still triggers the issue.
  • Hypothesis Generation: Encourages the formulation of falsifiable hypotheses to guide debugging efforts.
  • Instrumentation and Probing: Utilizes targeted logging and debugging techniques to validate hypotheses.
  • Regression Testing: Ensures that fixes are effective and do not introduce new issues.
  • Cleanup and Post-Mortem: Guides through the process of verifying the fix and documenting lessons learned for future prevention.

Quick Start

Run the 'diagnose-bug' command to initiate the diagnosis process for a specific issue.

Frequently Asked Questions about diagnosing-bugs

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

FAQPage Schema
How do I diagnose hard bugs and performance regressions systematically?▼

To diagnose hard bugs and performance regressions, you build a tight feedback loop, minimize the reproduction scenario, generate falsifiable hypotheses, and validate them using targeted instrumentation and logging.

What is the best way to find the root cause of a complex software bug?▼

Finding the root cause of a complex software bug requires minimizing the reproducible scenario to the smallest trigger, then probing the system with structured logging to validate falsifiable hypotheses.

How do I minimize a bug reproduction scenario for easier debugging?▼

Minimizing a bug reproduction scenario involves systematically reducing inputs and conditions until you isolate the smallest possible case that still triggers the bug for targeted root cause analysis.

Does bug diagnosis require structured logging and specific debugging practices?▼

Yes, effective bug diagnosis requires structured debugging practices and targeted logging to build feedback loops and validate hypotheses, making it suitable for software engineers dealing with complex issues.

What steps should I take after fixing a performance regression to prevent future issues?▼

After fixing a performance regression, run regression testing to verify the fix, clean up instrumentation, and document a post-mortem to capture lessons learned for future prevention.

Related Skills

Explore More Software Engineering Skills→
swghoshswghosh

reproduce

Reproduce reported software bugs and document reproduction steps in a structured report.

Community
Advanced
s3nex-coms3nex-com

incident-postmortem

Generate structured post-mortem documents for P1 and P2 production incidents.

Community
Advanced
JohannesKoningsJohannesKonings
9

diagnosing-bugs

Diagnose software bugs and performance regressions through deterministic feedback loops.

Community
Advanced
danielcopperdanielcopper
3

diagnose

Apply a six-phase debugging framework to resolve software defects and performance regressions.

Community
Advanced