omk-debugging

Enforce a root-cause investigation workflow with structured evidence and stage gates.

103|15|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/KaimingWan/oh-my-kiro --skill omk-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omk-debugging
Source: https://github.com/KaimingWan/oh-my-kiro/tree/main/skills/omk-debugging
Command: npx skills add https://github.com/KaimingWan/oh-my-kiro --skill omk-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging framework that enforces a disciplined, evidence-based approach to diagnose and fix bugs, reducing time to root cause.

Core Features & Use Cases

  • Investigation Protocol, L0-L2 evidence system, and a structured investigation template to capture findings.
  • Phase-driven workflow (Root Cause, Pattern Analysis, Hypothesis & Testing, Implementation) to guide debugging from symptoms to fix.
  • Reproducibility and safety rails: use of get_diagnostics, search_symbols, goto_definition to trace data flow, with a rigorous decision log and evidence tables.

Quick Start

Start a debugging session by creating an investigation document and following the four phases to trace root causes.

Frequently Asked Questions about omk-debugging

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

FAQPage Schema
How do I find the root cause of a software crash instead of just patching the symptom?

Systematic debugging enforces a root-cause investigation workflow by requiring diagnostic evidence collection through get_diagnostics and symbol searches before patching. It progresses through defined phases: Root Cause, Pattern Analysis, Hypothesis Testing, and Implementation.

What is the best way to debug unexpected test failures across complex codebases?

The best way to debug unexpected test failures is using a structured investigation template to capture findings. This workflow requires tracing data flow with goto_definition and search_symbols to build an L0-L2 evidence system before making code changes.

How does an evidence-based debugging workflow handle pattern analysis?

An evidence-based debugging workflow handles pattern analysis by gating investigation phases, ensuring you trace data flow and collect diagnostics before forming hypotheses. It uses a rigorous decision log to map symptoms to root causes systematically.

Can I use this debugging framework for non-trivial bugs in any environment?

Yes, you can use this debugging framework for any non-trivial debugging scenario, including crashes and unexpected behavior, across codebases and environments. It applies safety rails requiring diagnostic evidence collection before progressing to implementation.

When should I not use a systematic debugging workflow?

You should avoid a systematic debugging workflow for trivial fixes where the root cause is immediately obvious. It is designed for non-trivial scenarios requiring structured evidence collection, pattern analysis, and phase-driven validation before patching.