debug

Trace root causes and validate fixes through systematic debugging phases.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/toanalien/ezdevsecops --skill debug-toanalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/toanalien/ezdevsecops/tree/main/.opencode/skills/debug
Command: npx skills add https://github.com/toanalien/ezdevsecops --skill debug-toanalien

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured framework to systematically investigate and resolve bugs, test failures, and unexpected behavior by prioritizing root cause analysis over immediate fixes.

Core Features & Use Cases

  • Systematic Debugging: A four-phase approach (Investigation, Pattern Analysis, Hypothesis & Testing, Implementation) to ensure thorough problem-solving.
  • Root Cause Tracing: Techniques to trace errors back through call stacks to their origin.
  • Defense-in-Depth: Strategies for adding validation at multiple layers to prevent bugs from recurring.
  • Verification Protocols: Emphasizes evidence-based confirmation before claiming success.
  • Use Case: When a critical test fails unexpectedly, use this Skill to guide the investigation from understanding the error message to implementing a validated fix.

Quick Start

Use the debug skill to investigate a test failure by following the systematic debugging process.

Frequently Asked Questions about debug

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

FAQPage Schema
What is the best way to systematically debug unexpected software behavior?

To systematically debug software defects, follow a four-phase approach: Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation. This framework ensures thorough problem-solving by prioritizing root cause analysis over immediate fixes.

How do I trace the root cause of a test failure through the call stack?

Trace the root cause of a test failure by using root cause tracing techniques to follow errors back through the call stack to their origin. This systematic investigation isolates the exact source of the unexpected behavior.

Can I use this debugging framework for performance issues across any programming language?

Yes, this debugging framework is applicable to performance issues, bugs, and unexpected behavior across all programming languages. It provides language-agnostic systematic investigation and verification protocols for identifying software defects.

Do I need npm installed to run diagnostic scripts for bisection?

Yes, npm is required as a dependency to run the specific diagnostic scripts included in the framework. These scripts assist with targeted diagnostic tasks like bisection during the systematic debugging process.

How does defense-in-depth validation prevent bugs from recurring?

Defense-in-depth validation prevents recurring bugs by adding validation strategies at multiple layers of the software. This approach, combined with strict verification protocols, ensures evidence-based confirmation before claiming a fix is successful.