One-click install
npx skills add https://github.com/thomassloboda/ai-stuff --skill incident-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: incident-debugging
Source: https://github.com/thomassloboda/ai-stuff/tree/main/skills/incident-debugging
Command: npx skills add https://github.com/thomassloboda/ai-stuff --skill incident-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Incidents often lack a structured approach, leading to long outages, repeated symptoms, and unclear root causes. This skill provides a disciplined framework to collect symptoms, reproduce where possible, isolate faults, distinguish facts from hypotheses, validate fixes, and guard against regressions.

Core Features & Use Cases

  • Structured incident debugging workflow from symptom to verification.
  • Techniques for separating facts from hypotheses and validating root causes.
  • Guidance for regression testing and preventing reoccurrence across services.

Quick Start

Capture the observed symptom precisely and reproduce it when possible to begin the debugging workflow

Frequently Asked Questions about incident-debugging

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

FAQPage Schema
How do I debug a production incident methodically from symptom to fix?

Debug a production incident by following a structured workflow: collect observed symptoms precisely, reproduce the issue, isolate faults, distinguish facts from hypotheses, validate fixes, and run regression checks for verifiable stability.

What is the best way to isolate faults and find the root cause of a runtime error?

The best way to find a root cause is through fault isolation, which involves disciplined observation and separating verified facts from unverified hypotheses to pinpoint the exact trigger of a runtime error before applying a fix.

How do I reproduce a flaky test to determine if a regression occurred?

Reproduce a flaky test by capturing the exact observed symptom and environmental conditions precisely, then attempting consistent reproduction to confirm the fault isolation before proceeding with regression testing.

Can I use a structured debugging workflow for unexpected regressions across services?

Yes, a structured debugging workflow applies to unexpected regressions across services by guiding you through observation, reproduction, root-cause analysis, and regression checks to ensure verifiable production stability.

Why should I separate facts from hypotheses during root-cause analysis?

Separating facts from hypotheses during root-cause analysis prevents false assumptions, ensuring that fault isolation targets the actual trigger rather than speculative symptoms, leading to a safe and verifiable fix.

What are the limitations of debugging incidents without regression testing?

Without regression testing, debugging incidents lacks verifiable stability, increasing the risk of repeated symptoms and unclear root causes reoccurring across services after an initial fix is applied.