structured-debug

Guide software bug investigations from problem understanding to root cause verification.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/WinnerWang971119/my_skills --skill structured-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structured-debug
Source: https://github.com/WinnerWang971119/my_skills/tree/main/structured-debug
Command: npx skills add https://github.com/WinnerWang971119/my_skills --skill structured-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured debugging with a repeatable, evidence-driven framework to guide bug investigations from problem understanding to root cause and verification, reducing ad-hoc fixes and improving reproducibility.

Core Features & Use Cases

  • Guided problem framing, reproduction, and root-cause analysis workflow.
  • Clear escalation paths to team-debug for complex or multi-system issues.
  • Documented verification and sign-off process to ensure verifiable fixes.

Quick Start

Start a debugging session by stating the bug in natural language and asking the system to walk through problem understanding, reproduction, root-cause analysis, and verification.

Frequently Asked Questions about structured-debug

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

FAQPage Schema
How do I conduct structured debugging for a user-reported bug?

Structured debugging automates bug investigation by guiding you through problem understanding, reproduction, root-cause analysis, and verification. You start by stating the bug in natural language, and the system enforces evidence-based reasoning throughout.

What is the best way to establish bug reproducibility during root-cause analysis?

To establish bug reproducibility, use a guided problem framing workflow that enforces evidence-based reasoning and clear documentation. This framework requires step-by-step verification to confirm the issue before proceeding to root-cause analysis.

When should I escalate a software bug investigation to a team debug process?

Escalate a bug investigation when facing complex or multi-system issues. The structured debugging framework provides clear escalation paths to team-debug to manage these advanced scenarios when they exceed standard root-cause analysis.

Does structured debugging work for investigating unexpected software behavior?

Yes, structured debugging is designed for unexpected behavior and misbehavior cases. It applies an evidence-driven framework to guide the bug investigation process from initial problem understanding to final verification and sign-off.