investigate-incident

Investigate platform incidents by gathering evidence and generating root cause documentation.

1|1|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/redhat-et/kagenti-demo-deployment --skill investigate-incident
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate-incident
Source: https://github.com/redhat-et/kagenti-demo-deployment/tree/main/.claude/skills/investigate-incident
Command: npx skills add https://github.com/redhat-et/kagenti-demo-deployment --skill investigate-incident

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Incident investigation is often a chaotic, manual process involving multiple tools and a high risk of missing critical information. This skill provides a structured, automated workflow for incident response, guiding users through evidence gathering, root cause analysis, and documentation, significantly reducing resolution time and improving post-incident learning.

Core Features & Use Cases

  • Guided Investigation: Follow alert-specific runbooks and systematic steps to diagnose issues.
  • Automated Evidence Collection: Gather logs, metrics, events, and application status with pre-defined commands.
  • Structured RCA Documentation: Generate comprehensive incident reports in TODO_INCIDENTS.md for future learning.
  • Use Case: An alert for "Prometheus Down" has fired. Use this skill to automatically follow the Prometheus Down runbook, gather relevant logs and metrics, and start documenting the incident for root cause analysis.

Quick Start

Use the investigate-incident skill to start an investigation for the "Prometheus Down" alert, following its runbook and gathering initial evidence.

Frequently Asked Questions about investigate-incident

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

FAQPage Schema
How do I investigate a Kubernetes incident when an alert fires?

Incident investigation involves following alert-specific runbooks to gather logs, metrics, and pod status information systematically. This skill automates evidence collection and guides you through root cause analysis for Kubernetes platform incidents, reducing resolution time.

What should I do when a pod is in CrashLoopBackOff or ImagePullBackOff?

Use structured incident response to collect pod events, logs, and application status. This skill applies diagnostic workflows to determine why pods fail to start, document findings in incident reports, and track remediation steps for future reference.

How do I document root cause analysis after resolving an incident?

Root cause analysis documentation captures evidence, findings, and remediation in structured incident reports stored in `TODO_INCIDENTS.md`. This creates a record for post-incident learning and tracks how each alert was resolved.

Can I automate the gathering of logs and metrics during incident response?

Yes, automated evidence collection runs pre-defined commands to pull logs, metrics, events, and application status without manual tool-switching. This reduces the risk of missing critical information during investigations.

What's the best way to handle post-mortem documentation for operations teams?

Structured incident documentation workflows guide evidence gathering and RCA generation, producing comprehensive reports that support operations runbooks and enable knowledge sharing across your team.