debug-phase

Debug software errors by classifying, isolating root causes, and documenting fixes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/abner-magal/mcp-video-audio --skill debug-phase-abner-magal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-phase
Source: https://github.com/abner-magal/mcp-video-audio/tree/main/.opencode/skills/debug-phase
Command: npx skills add https://github.com/abner-magal/mcp-video-audio --skill debug-phase-abner-magal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured methodology to systematically debug software errors, ensuring that root causes are identified and fixed, not just symptoms, thereby preventing future occurrences.

Core Features & Use Cases

  • Error Classification: Categorize errors by type (Syntax, Runtime, Logic, Integration, Performance) and severity (Critical, High, Medium, Low).
  • Root Cause Analysis: Employ techniques like the "5 Whys" and binary search to pinpoint the origin of bugs.
  • TDD & Regression Testing: Write failing tests first, implement fixes, and add regression tests to ensure stability.
  • Documentation: Maintain a comprehensive error-log.md for historical tracking and knowledge sharing.
  • Use Case: When a critical bug is reported in production, use this Skill to follow a clear process: reproduce the error, classify it, find the root cause using 5 Whys, implement a fix with a test, and document everything to prevent recurrence.

Quick Start

Debug errors systematically by reproducing, classifying, isolating the root cause, fixing with a test, and documenting the solution.

Frequently Asked Questions about debug-phase

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

FAQPage Schema
How do I find the root cause of a software bug instead of just fixing symptoms?

To systematically debug software errors, follow a structured process: reproduce the error, classify it by type and severity, isolate the root cause, implement a fix with a test, and document the solution in error-log.md.

What is the best way to classify software errors during troubleshooting?

The best way to classify software errors during troubleshooting is by type—Syntax, Runtime, Logic, Integration, or Performance—and severity level, ranging from Critical to Low. This classification prioritizes debugging efforts effectively.

How do I use regression testing when fixing bugs?

To use regression testing when fixing bugs, write a failing test that reproduces the error first, implement the fix to make it pass, and add the test to your suite. This ensures stability and prevents future recurrence.

Why should I maintain an error log for bug fixing?

You should maintain an error-log.md for bug fixing to enable historical tracking and knowledge sharing. Documenting the error classification, root cause analysis, and fix implementation prevents similar issues and builds team debugging knowledge.

Can I use binary search to isolate runtime errors in my code?

Yes, you can use binary search to isolate runtime errors by systematically narrowing down the codebase sections where the error originates. This isolation method helps pinpoint the exact location of the bug efficiently.