debug-triage

Triage bugs and flaky tests through a repeatable debug loop.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/IAG-Patterns/DEMO_COPILOT_SKILLS --skill debug-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-triage
Source: https://github.com/IAG-Patterns/DEMO_COPILOT_SKILLS/tree/main/.github/skills/debug-triage
Command: npx skills add https://github.com/IAG-Patterns/DEMO_COPILOT_SKILLS --skill debug-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill gives teams a repeatable, evidence-first workflow to triage bugs and flaky tests: reproduce issues, minimize failing cases, hypothesize root causes, instrument code for visibility, implement fixes, and verify them through targeted tests.

Core Features & Use Cases

  • Reproduce and isolate flaky or failing tests with deterministic steps.
  • Minimize failing scenarios to the smallest reproducible case.
  • Hypothesize and instrument to surface root causes with minimal overhead.
  • Verify fixes by updating tests and re-running CI-aligned validation.
  • Use Case: When a flaky test intermittently fails in CI, apply this skill to reproduce, triage, and resolve with minimal risk to the rest of the suite.

Quick Start

Use the Debug Triage skill to reproduce a flaky test; minimize the failure; add temporary logs; implement a fix; run the test suite to verify.

Frequently Asked Questions about debug-triage

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

FAQPage Schema
What is the best way to triage flaky tests that fail intermittently in CI?

To triage flaky tests, you reproduce the failure, minimize it to the smallest case, hypothesize root causes, add temporary instrumentation, implement a fix, and run CI-aligned validation.

How do I minimize a failing test to find the root cause?

To minimize a failing test, you reduce the failing scenario to the smallest reproducible case, then add temporary instrumentation to surface the root cause with minimal overhead before applying a fix.

How do I reproduce flaky test failures deterministically?

Reproducing flaky test failures requires following deterministic steps to isolate the issue, ensuring you can reliably trigger the failing scenario before moving on to minimization and root-cause analysis.

Can I apply debug triage to any failing software scenario, or only flaky tests?

This debug triage workflow applies to any failing or flaky scenario across software projects, guiding reproduction, minimization, hypothesis, instrumentation, fixes, and verification.

What are the limitations of using temporary instrumentation for root-cause analysis?

Temporary instrumentation is used to surface root causes with minimal overhead, but it must be paired with CI-aligned verification to ensure fixes resolve the issue without risking the rest of the suite.