debug-bug

Reproduce reported software failures, identify root causes, and verify minimal fixes.

2|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Mybigwang/project-agent --skill debug-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-bug
Source: https://github.com/Mybigwang/project-agent/tree/main/src/project_agent/skills/builtin/debug-bug
Command: npx skills add https://github.com/Mybigwang/project-agent --skill debug-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you debug failing behavior by guiding you to confirm the observable issue, trace it to its real root cause, and apply the smallest safe code change that resolves the problem.

Core Features & Use Cases

  • Reproduction-first debugging: Verifies the bug with concrete evidence before attempting fixes, reducing guesswork.
  • Root-cause focused investigation: Prioritizes identifying underlying causes rather than only addressing surface-level error messages.
  • Minimal-change repair with verification: Encourages the smallest modification needed and requires validation through relevant tests or checks.

Quick Start

Use this skill when you can describe the failing behavior or error; tell it the problem description you see (and any relevant logs or symptoms) and ask it to locate the root cause, propose a minimal fix, and validate it with the appropriate test or verification command.

Frequently Asked Questions about debug-bug

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

FAQPage Schema
How do I find the root cause of a Python error instead of just fixing the symptom?

Root cause analysis traces observable symptoms back to their underlying origin. Debug-bug guides you to verify the failing behavior with concrete evidence first, ensuring you identify and fix the actual source of the regression rather than just patching the surface-level error message.

What is the best way to debug a failing behavior and apply a minimal code fix?

The best way to apply a minimal code fix is through evidence-driven debugging. Debug-bug prioritizes making the smallest safe modification needed to resolve the failing behavior, then requires validation through relevant tests or checks to confirm the issue is corrected.

How do I verify a suspected regression using test verification?

To verify a suspected regression, you must run related tests or checks after making minimal edits. Debug-bug requires validation through appropriate test verification commands to confirm the root cause is resolved and the failing behavior is eliminated.

Does error investigation require reproducing the issue before attempting fixes?

Yes, error investigation requires reproducing the issue before attempting fixes. Debug-bug uses a reproduction-first approach, verifying the bug with concrete evidence to reduce guesswork and ensure the root cause analysis targets the actual failure.

When should I not use a minimal fix for software failures?

You should not use a minimal fix for software failures when the problem requires broad architectural changes or lacks clear reproduction steps. Debug-bug applies to scenarios with a constrained change scope where the error can be verified with concrete evidence.