A diagnostic tool to score and flag unreliable GitHub Actions workflows used in pull request and merge queue gates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install github-actions-pr-gate-health-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-pr-gate-health-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 PR Gate Health Audit?
The GitHub Actions PR Gate Health Audit is a powerful analysis tool designed for DevOps teams using Openclaw Skills to maintain high CI/CD standards. It identifies flaky tests, sluggish queues, and unreliable merge gates by processing GitHub Actions run data. By scoring workflows based on failure patterns and latency, it ensures that developer productivity isn't hindered by unstable automation pipelines.
This skill provides a systematic way to look beyond individual build failures and see the broader health of your automation. By analyzing trends in queue wait times and consecutive failures, teams can proactively address infrastructure bottlenecks before they result in developer frustration or production risks.
GitHub Actions PR Gate Health Audit Use Cases
- Monitoring the stability of pull request checks across multiple repositories.
- Identifying flaky workflows that cause unnecessary merge delays.
- Auditing queue wait times to optimize CI runner allocation.
- Detecting stale success risks where a workflow hasn't passed successfully in several days.
- Creating automated quality gates that fail builds based on aggregate pipeline health metrics.
How GitHub Actions PR Gate Health Audit Works
- Collect GitHub Actions run data as JSON files using the GitHub CLI command line tools.
- Filter the collected data based on specific event types such as pull_request, pull_request_target, or merge_group.
- Group the run data by repository, workflow name, and trigger event type.
- Calculate health and risk scores using failure rates, consecutive failures, average queue wait times, and time since the last success.
- Compare the results against configurable warning and critical thresholds defined in the environment variables.
- Generate a detailed text report for human review or a JSON output for integration with operational dashboards.
GitHub Actions PR Gate Health Audit Setup
To utilize this within Openclaw Skills, ensure your environment has bash and python3 available.
First, collect the necessary run data from GitHub:
gh run view <run-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,runStartedAt,updatedAt,url,repository > artifacts/github-actions/run-<run-id>.json
Then, execute the audit script with your desired configuration:
RUN_GLOB='artifacts/github-actions/*.json' \
EVENT_MATCH='^(pull_request|merge_group)$' \
MIN_RUNS=3 \
bash skills/github-actions-pr-gate-health-audit/scripts/pr-gate-health-audit.sh
GitHub Actions PR Gate Health Audit Data Schema & Taxonomy
The skill processes JSON files exported from the GitHub API and organizes the analysis into a scored hierarchy. The data taxonomy includes:
| Attribute | Description |
|---|---|
| repository | The source GitHub repository containing the workflow. |
| workflowName | The specific name of the GitHub Action being audited. |
| event | The trigger event type (e.g., pull_request, merge_group). |
| health_score | A composite risk metric where higher numbers indicate lower reliability. |
| failure_rate | The percentage of failed runs within the analyzed sample. |
| queue_wait | The average time elapsed between run creation and the actual start time. |
GitHub Actions PR Gate Health Audit Advanced Features
- Custom Regex Filtering: Include or exclude specific repositories, workflows, or events using REPO_MATCH and WORKFLOW_MATCH.
- Configurable Thresholds: Define custom limits for failure percentages, queue latency, and staleness to match your team's SLAs.
- CI Gate Integration: Enable FAIL_ON_CRITICAL to force non-zero exit codes when reliability scores drop below acceptable levels.
- Multi-Format Output: Toggle between human-readable summaries and machine-parseable JSON for automated reporting.
- Stale Success Detection: Automatically flags workflows that have not seen a successful run within a specified window of days.
SKILL.md
Loading
Related Openclaw Skills
GitHub Actions Permission Scope Audit
A security-focused tool to detect and audit over-privileged GitHub Actions workflow tokens to enforce least-privilege access.
GitHub Actions OIDC Hardening Audit
A security auditing tool for GitHub Actions that identifies OIDC misconfigurations and risky cloud authentication patterns.
GitHub Actions Merge Queue Health Audit
A diagnostic tool for auditing GitHub merge queue workflows using failure rates, queue latency, and stale-success risk scoring.
GitHub Actions Manual Trigger Audit
A diagnostic tool to detect and audit manual trigger reliance in GitHub Actions workflows to improve automation and pipeline reliability.
GitHub Actions Queue Latency Audit
Identify and visualize GitHub Actions queue wait hotspots from run metadata to resolve CI bottlenecks before they stall development merges.
GitHub Actions Recovery Latency Audit
A diagnostic tool to measure how quickly GitHub Actions workflows recover from failures and identify persistent CI bottlenecks.
METADATA
Featured*
