GitHub Actions Incident Timeline Audit
/install github-actions-incident-timeline-audit
GitHub Actions Incident Timeline Audit
Use this skill to convert noisy failed run exports into incident windows you can triage quickly during CI reliability reviews.
What this skill does
- Reads GitHub Actions run JSON exports
- Keeps only failed/cancelled/timed-out style outcomes
- Groups failures by repository into incident windows using a configurable gap threshold
- Scores each incident using failed-run and duration thresholds
- Emits text or JSON output for review docs, ops dashboards, and CI fail gates
Inputs
Optional:
RUN_GLOB(default:artifacts/github-actions/*.json)TOP_N(default:20)OUTPUT_FORMAT(textorjson, default:text)INCIDENT_GAP_MINUTES(default:45)WARN_FAILED_RUNS(default:2)CRITICAL_FAILED_RUNS(default:4)WARN_DURATION_MINUTES(default:20)CRITICAL_DURATION_MINUTES(default:60)WORKFLOW_MATCH(regex, optional)WORKFLOW_EXCLUDE(regex, optional)REPO_MATCH(regex, optional)REPO_EXCLUDE(regex, optional)FAIL_ON_CRITICAL(0or1, default:0)
Collect run JSON
gh run view \x3Crun-id> --json databaseId,workflowName,event,conclusion,headBranch,createdAt,updatedAt,startedAt,url,repository \
> artifacts/github-actions/run-\x3Crun-id>.json
Run
Text report:
RUN_GLOB='artifacts/github-actions/*.json' \
INCIDENT_GAP_MINUTES=45 \
bash skills/github-actions-incident-timeline-audit/scripts/incident-timeline-audit.sh
JSON output with fail gate:
RUN_GLOB='artifacts/github-actions/*.json' \
OUTPUT_FORMAT=json \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-incident-timeline-audit/scripts/incident-timeline-audit.sh
Run with bundled fixtures:
RUN_GLOB='skills/github-actions-incident-timeline-audit/fixtures/*.json' \
bash skills/github-actions-incident-timeline-audit/scripts/incident-timeline-audit.sh
Output contract
- Exit
0in report mode (default) - Exit
1whenFAIL_ON_CRITICAL=1and one or more incidents are critical - Text mode prints summary + ranked incident windows
- JSON mode prints summary + incidents + critical incident details
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-actions-incident-timeline-audit - After installation, invoke the skill by name or use
/github-actions-incident-timeline-audit - Provide required inputs per the skill's parameter spec and get structured output
What is GitHub Actions Incident Timeline Audit?
Cluster failed GitHub Actions runs into incident windows by repo to expose outage duration, impact scope, and escalation severity. It is an AI Agent Skill for Claude Code / OpenClaw, with 262 downloads so far.
How do I install GitHub Actions Incident Timeline Audit?
Run "/install github-actions-incident-timeline-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Actions Incident Timeline Audit free?
Yes, GitHub Actions Incident Timeline Audit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does GitHub Actions Incident Timeline Audit support?
GitHub Actions Incident Timeline Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Actions Incident Timeline Audit?
It is built and maintained by Daniel Lummis (@daniellummis); the current version is v1.0.0.