GitHub Actions Incident Timeline Audit for Openclaw

A specialized tool to cluster noisy GitHub Actions failure logs into structured incident windows for better CI reliability reporting.

daniellummis
v1.0.0
Mar 7, 2026
0
754
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install github-actions-incident-timeline-audit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install github-actions-incident-timeline-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is GitHub Actions Incident Timeline Audit?

The GitHub Actions Incident Timeline Audit is a powerful utility designed to help DevOps teams move beyond individual error logs and see the bigger picture of CI health. By analyzing exported run data, this skill identifies periods of systemic failure, effectively grouping individual workflow errors into logical incident windows based on time gaps and repository context. This approach is essential for teams using Openclaw Skills to maintain high-performance CI/CD pipelines.

This skill provides clear visibility into outage duration, impact scope, and escalation severity. It allows engineers to distinguish between isolated flakiness and widespread infrastructure issues, making it an indispensable part of any post-mortem or reliability review process.

GitHub Actions Incident Timeline Audit Use Cases

  • Conducting post-mortem reviews for CI/CD outages and downtime.
  • Calculating Mean Time to Resolution (MTTR) for workflow failures.
  • Implementing automated fail-gates in deployment pipelines based on incident severity.
  • Aggregating GitHub Actions telemetry for executive operations dashboards.

How GitHub Actions Incident Timeline Audit Works

  1. Scans a specified directory for GitHub Actions run metadata exported in JSON format.
  2. Filters the dataset to isolate failed, cancelled, or timed-out run conclusions.
  3. Clusters consecutive failures into discrete incident windows using a configurable time-gap threshold.
  4. Calculates severity scores for each incident window based on the number of failures and total duration.
  5. Produces a formatted report or a raw JSON output for further integration or alerting.

GitHub Actions Incident Timeline Audit Setup

First, use the GitHub CLI to export your run metadata to the expected artifacts directory:

gh run view <run-id> --json databaseId,workflowName,event,conclusion,headBranch,createdAt,updatedAt,startedAt,url,repository \
  > artifacts/github-actions/run-<run-id>.json

To run a standard text-based report using this Openclaw Skills component, execute the following command:

RUN_GLOB='artifacts/github-actions/*.json' \
INCIDENT_GAP_MINUTES=45 \
bash skills/github-actions-incident-timeline-audit/scripts/incident-timeline-audit.sh

GitHub Actions Incident Timeline Audit Data Schema & Taxonomy

The skill processes JSON objects containing specific GitHub run attributes. It expects files to be organized in a flat directory structure.

Property Purpose
databaseId Unique identifier for the run
conclusion The final state of the run (e.g., failure, timed_out)
startedAt ISO 8601 timestamp of when the run began
updatedAt ISO 8601 timestamp of completion, used to calculate duration
repository The repository name used for grouping incidents

GitHub Actions Incident Timeline Audit Advanced Features

  • Custom severity scoring for Warning and Critical thresholds based on failure volume and duration.
  • Regex filtering support for inclusive or exclusive matching of workflows and repositories.
  • Programmatic fail-gate integration using exit codes (Exit 1 when critical incidents are detected).
  • Support for multiple output formats including human-readable text and machine-parseable JSON for automated workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins bashpython3
Github Stars: 0
forks: 0

Featured*