github-actions-pr-gate-health-audit
Audit pull-request and merge-queue GitHub Actions reliability by scoring failure rate, queue latency, and stale-success risk for merge gates.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/daniellummis/github-actions-pr-gate-health-auditGitHub Actions PR Gate Health Audit
Use this skill to detect unreliable pull-request merge gates before they block developers or hide degraded CI health.
What this skill does
- Reads GitHub Actions run JSON exports
- Filters to PR/merge-gate events by default (
pull_request,pull_request_target,merge_group) - Groups by repository + workflow + event
- Scores risk using:
- failure rate
- consecutive current failures
- average queue wait before run start
- days since last successful run
- Flags warning/critical groups via configurable thresholds
- Emits text or JSON output for CI gates and operational dashboards
Inputs
Optional:
RUN_GLOB(default:artifacts/github-actions/*.json)TOP_N(default:20)OUTPUT_FORMAT(textorjson, default:text)MIN_RUNS(default:2)EVENT_MATCH(default:^(pull_request|pull_request_target|merge_group)$)WORKFLOW_MATCH(regex, optional)WORKFLOW_EXCLUDE(regex, optional)REPO_MATCH(regex, optional)REPO_EXCLUDE(regex, optional)FAIL_WARN_PERCENT(default:15)FAIL_CRITICAL_PERCENT(default:30)QUEUE_WARN_SECONDS(default:120)QUEUE_CRITICAL_SECONDS(default:300)SUCCESS_STALE_DAYS(default:3)WARN_SCORE(default:25)CRITICAL_SCORE(default:45)FAIL_ON_CRITICAL(0or1, default:0)
Collect run JSON
gh run view <run-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,runStartedAt,updatedAt,url,repository \
> artifacts/github-actions/run-<run-id>.json
Run
Text report:
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
JSON output with fail gate:
RUN_GLOB='artifacts/github-actions/*.json' \
OUTPUT_FORMAT=json \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-pr-gate-health-audit/scripts/pr-gate-health-audit.sh
Run with bundled fixtures:
RUN_GLOB='skills/github-actions-pr-gate-health-audit/fixtures/*.json' \
bash skills/github-actions-pr-gate-health-audit/scripts/pr-gate-health-audit.sh
Output contract
- Exit
0in report mode (default) - Exit
1whenFAIL_ON_CRITICAL=1and one or more groups are critical - Text mode prints summary + ranked PR gate risk groups
- JSON mode prints summary + scored groups + critical group details
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-daniellummis-github-actions-pr-gate-health-audit": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
github-actions-recovery-latency-audit
Measure GitHub Actions failure recovery latency and unresolved incident age by workflow group.
github-actions-cache-hardening-audit
Audit GitHub Actions workflow cache usage for poisoning, keying, and secret-path risks.
render-env-guard
Preflight-check Render service environment variables before deploys; catches missing keys and placeholder/template values that commonly break production rollouts.
github-actions-trigger-health-audit
Audit GitHub Actions run health by trigger event and workflow so flaky or noisy automation sources are easy to prioritize.
github-actions-run-gap-audit
Detect GitHub Actions workflow groups that stopped running on their normal cadence using median run intervals and current inactivity gap.