debug-triage

Isolate failing infrastructure layers using evidence-based diagnostic checks.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/iuliandita/skills --skill debug-triage-iuliandita
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-triage
Source: https://github.com/iuliandita/skills/tree/main/skills/debug-triage
Command: npx skills add https://github.com/iuliandita/skills --skill debug-triage-iuliandita

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of "incident noise" where engineers waste time guessing the cause of a system failure. It provides a structured, evidence-based method to isolate the failing layer in a complex stack before any diagnostic or remediation work begins.

Core Features & Use Cases

  • Layer Localization: Systematically excludes healthy layers (DNS, Network, TLS, Ingress, etc.) using the cheapest discriminating checks first.
  • Explicit Handoff: Once the failure is localized, it routes the incident to the specific domain skill (e.g., networking, databases, kubernetes) responsible for that layer.
  • Use Case: When a service reports 502 errors, use this skill to determine if the issue is a misconfigured ingress, a dead backend pod, or a network routing failure, preventing unnecessary deep dives into the wrong component.

Quick Start

Use the debug-triage skill to analyze the current incident and identify the failing layer based on the provided symptoms.

Frequently Asked Questions about debug-triage

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

FAQPage Schema
How do I troubleshoot a production incident when the root cause is unknown?

To troubleshoot an unknown production incident, systematically isolate failing infrastructure layers by running evidence-based diagnostic checks. This method excludes healthy layers like DNS and TLS first, preventing wasted time on unnecessary deep dives into the wrong component.

How do I triage Kubernetes 502 errors to find the failing layer?

Triage Kubernetes 502 errors by applying layer localization to determine if a misconfigured ingress, dead backend pod, or network routing failure is responsible. This process uses non-destructive signal analysis to isolate the exact failing component before deeper investigation.

Do I need Kubernetes CLI access to perform system outage triage?

Yes, you need Kubernetes CLI access and standard Linux diagnostic utilities to perform system outage triage. These tools execute the non-destructive signal analysis required to systematically investigate cross-layer failures during production incidents.

What is the best way to isolate live system incidents across multiple layers?

The best way to isolate live system incidents is to use the cheapest discriminating checks first, systematically excluding healthy layers like DNS, Network, and Ingress. This evidence-based approach localizes the failure before routing to a specific domain skill.

What happens after triage localizes the failing infrastructure layer?

After triage localizes the failing infrastructure layer, the process triggers an explicit handoff. It routes the incident directly to the specific domain skill responsible for that layer, such as networking, databases, or kubernetes, for targeted remediation.

When should I not use a systematic triage approach for incident troubleshooting?

You should avoid this systematic triage approach when the failing infrastructure layer is already known, or when destructive diagnostic methods are required. It is specifically designed for unknown root causes needing cross-layer investigation using non-destructive checks.