debug

Guide systematic bug investigation through reproduction, root cause analysis, and regression tests.

1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/hypeJunction/ai-assistant-starter --skill debug-hypejunction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/hypeJunction/ai-assistant-starter/tree/main/skills/debug
Command: npx skills add https://github.com/hypeJunction/ai-assistant-starter --skill debug-hypejunction

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured, systematic approach to identifying and fixing bugs, ensuring that the root cause is addressed and prevented from recurring.

Core Features & Use Cases

  • Root Cause Analysis: Guides you through analyzing symptoms to find the underlying problem, not just the surface-level error.
  • Regression Testing: Ensures that every fix is accompanied by a test that would have caught the original bug.
  • Use Case: When a critical bug is reported in production, use this Skill to methodically reproduce the issue, pinpoint the exact line of code causing the problem, implement a robust fix, and add a test to prevent its reoccurrence.

Quick Start

Use the debug skill to investigate why the user list API is returning a 500 error in production.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I perform root cause analysis for a production bug?

Root cause analysis for a production bug involves systematically reproducing the issue, investigating symptoms to pinpoint the exact underlying problem, and verifying the fix with regression tests to prevent recurrence.

What is the best way to fix runtime errors and prevent them from happening again?

Fixing runtime errors and preventing recurrence requires a systematic approach of reproducing the issue, addressing the root cause rather than surface-level symptoms, and adding a regression test that would have caught the original bug.

How do I troubleshoot unexpected behavior and performance regressions in my code?

Troubleshooting unexpected behavior and performance regressions requires strict debugging principles, guiding you through methodical issue reproduction, root cause identification, and implementing a robust fix with verification.

Can I use systematic debugging for test failures and API errors?

Yes, systematic debugging can be used for test failures and API errors, guiding you to methodically reproduce the issue, pinpoint the exact line of code causing the problem, and add tests to prevent reoccurrence.

When should I use systematic bug fixing instead of quick patches?

You should use systematic bug fixing instead of quick patches when addressing critical production issues, ensuring the root cause is resolved and accompanied by regression tests rather than just fixing surface-level errors.