A diagnostic tool for auditing GitHub merge queue workflows using failure rates, queue latency, and stale-success risk scoring.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install github-actions-merge-queue-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-merge-queue-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 Merge Queue Health Audit?
This skill provides a specialized auditing framework designed to maintain the health of GitHub Actions workflows, specifically those utilizing the merge_group event. By analyzing exported run data, it helps engineering teams identify bottlenecks and flaky tests before they stall the development pipeline. Leveraging Openclaw Skills in your automation stack allows for proactive monitoring of CI health, ensuring that merge gates remain fast and reliable.
The tool generates health scores based on critical metrics like P95 queue latency and failure percentages. It transforms raw data into actionable insights, categorizing workflow health into ok, warn, or critical states. This is essential for organizations managing complex monorepos or high-frequency merge queues where CI performance directly impacts developer velocity.
GitHub Actions Merge Queue Health Audit Use Cases
- Identifying flaky workflows that degrade the reliability of the merge queue.
- Monitoring and reducing queue latency to improve developer feedback loops.
- Detecting stale-success risks where outdated results might allow broken code to be merged.
- Implementing automated CI health gates that block further merges when workflow stability drops below a defined threshold.
How GitHub Actions Merge Queue Health Audit Works
- The skill reads GitHub Actions run metadata exported in JSON format via the GitHub CLI.
- It filters the data to focus on merge queue style events such as merge_group.
- The audit engine aggregates health metrics by repository, workflow, or specific branch.
- It calculates risk scores by evaluating failure rates, queue wait times, and the age of successful runs.
- It outputs a ranked report and can optionally trigger a non-zero exit code if health thresholds are violated.
GitHub Actions Merge Queue Health Audit Setup
First, ensure you have the GitHub CLI installed and authenticated. Collect your run data using the following command:
gh run view <run-id> --json databaseId,workflowName,event,headBranch,status,conclusion,createdAt,runStartedAt,updatedAt,url,repository > artifacts/github-actions/run-<run-id>.json
Once the data is collected, execute the audit via Openclaw Skills by running the script:
RUN_GLOB='artifacts/github-actions/*.json' bash skills/github-actions-merge-queue-health-audit/scripts/merge-queue-health-audit.sh
GitHub Actions Merge Queue Health Audit Data Schema & Taxonomy
The skill expects JSON input containing specific GitHub Actions metadata. The following fields are primarily utilized for calculation:
| Field | Purpose |
|---|---|
workflowName |
Used for grouping and identifying specific CI tasks. |
event |
Filters for merge_group or pull_request triggers. |
conclusion |
Determines the failure/success rate. |
createdAt |
Calculates the total time spent in the queue. |
runStartedAt |
Determines when the runner picked up the job. |
updatedAt |
Used to calculate total execution time and staleness. |
GitHub Actions Merge Queue Health Audit Advanced Features
- Support for regex-based workflow and branch matching or exclusion.
- Configurable thresholds for failure rates (defaulting to 20% for warnings and 40% for critical errors).
- Deterministic replay support using ISO timestamp overrides for historical auditing.
- Automated CI fail-gate integration using the FAIL_ON_CRITICAL environment variable.
- Flexible output formatting providing either human-readable text reports or machine-parseable JSON.
SKILL.md
Loading
Related Openclaw Skills
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 Mainline Health Audit
A diagnostic tool that scores the reliability of GitHub Actions workflows on protected branches to detect silent delivery degradation.
GitHub Actions Incident Timeline Audit
A specialized tool to cluster noisy GitHub Actions failure logs into structured incident windows for better CI reliability reporting.
GitHub Actions Failure Streak Audit
Audit GitHub Actions run history to identify and rank consecutive failure streaks that disrupt software delivery.
GitHub Actions OIDC Hardening Audit
A security auditing tool for GitHub Actions that identifies OIDC misconfigurations and risky cloud authentication patterns.
GitHub Actions Permission Scope Audit
A security-focused tool to detect and audit over-privileged GitHub Actions workflow tokens to enforce least-privilege access.
METADATA
Featured*
