A diagnostic tool to identify GitHub Actions workflows that have missed their expected execution cadence.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install github-actions-run-gap-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install github-actions-run-gap-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 Run Gap Audit?
The GitHub Actions Run Gap Audit skill provides an automated way to monitor the health of your CI/CD pipelines by analyzing the frequency of GitHub Actions runs. By calculating the median and p90 intervals from historical data, it identifies gaps where automation may have failed, been disabled, or suffered from branch drift. As a vital component of the Openclaw Skills library, it helps maintain high availability for your development workflows by surfacing silent failures that traditional monitoring might miss.
GitHub Actions Run Gap Audit Use Cases
- Identifying silent failures in scheduled cron workflows.
- Detecting when automation triggers stop firing due to configuration errors or stale triggers.
- Auditing branch-specific workflow health across multiple repositories.
- Implementing CI/CD guardrails to fail builds if critical background workflows are found to be stale.
How GitHub Actions Run Gap Audit Works
- The skill ingests GitHub Actions run data in JSON format, typically gathered via the GitHub CLI.
- It groups the ingested data by repository, workflow name, branch, and event type to establish distinct execution streams.
- Historical cadence is computed using median and p90 interval statistics to understand the expected frequency.
- It measures the current inactivity gap relative to the last successful run recorded.
- Risk scores (ok, warn, critical) are assigned based on configurable multipliers applied to the historical cadence.
- The skill emits a report in text or JSON format, allowing for manual triage or automated pipeline gating.
GitHub Actions Run Gap Audit Setup
To use this skill, first collect run data using the GitHub CLI:
gh run view <run-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,updatedAt,startedAt,url,repository > artifacts/github-actions/run-<run-id>.json
Then, execute the audit script with your desired configuration using Openclaw Skills commands:
RUN_GLOB='artifacts/github-actions/*.json' \
MIN_RUNS=5 \
bash skills/github-actions-run-gap-audit/scripts/run-gap-audit.sh
GitHub Actions Run Gap Audit Data Schema & Taxonomy
This skill processes JSON exports and organizes metadata into a structured audit schema:
| Attribute | Description |
|---|---|
| Grouping | Unique identifier combining Repo, Workflow, Branch, and Event |
| Cadence Metrics | Calculated median and p90 hours between execution intervals |
| Inactivity Gap | The duration in hours since the most recent workflow run |
| Risk Severity | Status (ok, warn, critical) determined by gap multipliers |
| Filter Metadata | Supports regex matching for targeting specific repos or workflows |
GitHub Actions Run Gap Audit Advanced Features
- Customizable risk thresholds using the WARN_GAP_MULTIPLIER and CRITICAL_GAP_MULTIPLIER environment variables.
- Extensive regex-based filtering for repositories, workflows, branches, and events to narrow audit scope.
- Support for deterministic CI testing by providing a fixed evaluation time via the NOW_ISO parameter.
- Automated fail-gates for CI pipelines that trigger an exit code 1 when critical gaps are detected.
- Flexible output formatting providing both human-readable text reports and machine-parseable JSON for Openclaw Skills integrations.
SKILL.md
Loading
Related Openclaw Skills
GitHub Actions Retry Recovery Audit
Analyze GitHub Actions run history to identify and quantify the cost of flaky fail-then-success retry patterns.
GitHub Actions Rerun Waste Audit
A technical auditing tool to quantify wasted GitHub Actions minutes by analyzing workflow reruns and flakiness data.
GitHub Actions Rerun Effectiveness Audit
A performance auditing tool to measure the effectiveness of GitHub Actions reruns and identify wasted CI resources.
GitHub Actions Recovery Latency Audit
A diagnostic tool to measure how quickly GitHub Actions workflows recover from failures and identify persistent CI bottlenecks.
GitHub Actions Runtime Regression Audit
Analyze and compare GitHub Actions runtime metrics to detect performance regressions and optimize CI costs.
GitHub Actions Secret Exposure Audit
An automated auditing tool to identify and mitigate secret exposure risks within GitHub Actions workflow configurations.
METADATA
Featured*
