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.