debugging

Diagnose software bugs through root cause analysis and structured investigation.

20|1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill debugging-krzysztofsurdy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/krzysztofsurdy/code-virtuoso/tree/main/skills/knowledge/debugging
Command: npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill debugging-krzysztofsurdy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a systematic methodology to identify the root cause of bugs, ensuring fixes are effective and prevent recurrence, rather than just treating symptoms.

Core Features & Use Cases

  • Reproduce Bugs: Guides users through reliably reproducing issues before investigation.
  • Root Cause Analysis: Employs a phased approach (Reproduce, Investigate, Hypothesize, Test, Fix, Prevent) for thorough diagnosis.
  • Bug Category Strategies: Offers tailored investigation techniques for different bug types (logic, data, state, integration, performance, environment, intermittent).
  • Use Case: When a critical production error occurs, this Skill helps engineers systematically trace the issue from symptom to root cause, ensuring a robust fix and preventing future occurrences.

Quick Start

Use the debugging skill to investigate a bug by following the reproduce-investigate-hypothesize-fix-prevent workflow.

Frequently Asked Questions about debugging

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

FAQPage Schema
What is the best way to find the root cause of a software bug instead of just treating symptoms?

Root cause analysis is the best way to find software bugs, utilizing a systematic reproduce-investigate-hypothesize-fix-prevent workflow. This methodology ensures your fixes address the underlying problem rather than just the manifestation, preventing future recurrence.

How do I systematically debug an intermittent production incident?

To debug an intermittent production incident, systematically reproduce the issue and investigate evidence. This approach provides tailored bug category strategies for intermittent failures, guiding you through structured diagnosis to hypothesis and testing.

How can I reliably reproduce a bug before starting an investigation?

To reliably reproduce a bug before investigation, follow a structured methodology that prioritizes evidence-based diagnosis. This systematic approach ensures you can consistently trigger the issue before moving to the hypothesis and fix phases.

Does this root cause analysis methodology offer strategies for different bug categories like logic or performance issues?

Yes, this root cause analysis methodology offers tailored investigation techniques for different bug categories including logic, data, state, integration, performance, environment, and intermittent issues to ensure thorough diagnosis.

When should I escalate a software bug during incident response?

You should escalate a software bug during incident response based on specific criteria defined within the debugging workflow. This methodology includes escalation criteria to determine when an issue exceeds current diagnostic capacity.

Why does fixing a symptom often lead to the same bug recurring in software troubleshooting?

Fixing a symptom leads to recurrence because the underlying root cause remains unaddressed in software troubleshooting. A systematic methodology ensures fixes target the root problem through structured investigation and testing, preventing future occurrences.