Incident Triage
/install incident-triage
Incident Triage
Structured incident triage for alerts from any monitoring source. Five steps, consistent every time.
Pass in the raw alert message, a link to the alert, or a description of what's happening.
Triage Process
When an alert appears:
- Classify — what type and severity?
- Scope — blast radius: who's affected, which environment, since when?
- Correlate — what changed recently? Check deploys, merges, config changes
- Investigate — guided checks based on alert type
- Act — summarize, create ticket, escalate or close
Read references/triage-framework.md for the full framework with checklists and bash snippets for each step.
Alert Parsing
Before starting the triage framework, identify the alert source and extract key fields.
Read references/alert-patterns.md for patterns covering PagerDuty, Datadog, CloudWatch, Sentry, uptime monitors, GitHub Actions, AWS SNS/EventBridge, and custom webhooks.
Escalation
When to page, when to watch, when to close. Severity-based response times and communication templates.
Read references/escalation-guide.md for defaults — customize for your team's on-call structure.
Runbook
During Step 4 (Investigate), load references/runbook-template.md to find service health endpoints, dashboards, log locations, and common fixes.
⚠️ This file is a template — it must be filled in before use. If it still contains
\x3C!--placeholder comments, tell the user to populate it with their actual infrastructure before relying on it during an incident.
Scripts
The scripts/ directory contains helper scripts for the correlation and action steps:
scripts/correlate-recent-deploys.sh— list recent CI/CD runs for a repo (Step 3)scripts/correlate-recent-merges.sh— list recently merged PRs for a repo (Step 3)scripts/create-incident-issue.sh— create a GitHub incident issue (Step 5)
Works Well With
- github (Step 3 — Correlate): check recent deploys, merged PRs, and CI run history for affected repos
- aws-ecs-monitor (Step 4 — Investigate): ECS service health, ALB targets, and CloudWatch logs for downtime and resource alerts
- gh-issues (Step 5 — Act): create incident tickets automatically
References
- references/triage-framework.md — full 5-step triage process with checklists
- references/alert-patterns.md — parsing alerts from common sources
- references/escalation-guide.md — severity levels, response times, escalation policy
- references/runbook-template.md — your infrastructure map (⚠️ fill in before use)
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install incident-triage - After installation, invoke the skill by name or use
/incident-triage - Provide required inputs per the skill's parameter spec and get structured output
What is Incident Triage?
Structured incident triage for alerts from any monitoring source. Five-step framework: classify severity, scope blast radius, correlate with recent changes,... It is an AI Agent Skill for Claude Code / OpenClaw, with 152 downloads so far.
How do I install Incident Triage?
Run "/install incident-triage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Incident Triage free?
Yes, Incident Triage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Incident Triage support?
Incident Triage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Incident Triage?
It is built and maintained by Grace Gettert (@ggettert); the current version is v0.3.0.