← Back to Skills Marketplace
daniellummis

GitHub Actions PR Gate Health Audit

by Daniel Lummis · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
295
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install github-actions-pr-gate-health-audit
Description
Audit pull-request and merge-queue GitHub Actions reliability by scoring failure rate, queue latency, and stale-success risk for merge gates.
README (SKILL.md)

GitHub 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 (text or json, 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 (0 or 1, default: 0)

Collect run JSON

gh run view \x3Crun-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,runStartedAt,updatedAt,url,repository \
  > artifacts/github-actions/run-\x3Crun-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 0 in report mode (default)
  • Exit 1 when FAIL_ON_CRITICAL=1 and one or more groups are critical
  • Text mode prints summary + ranked PR gate risk groups
  • JSON mode prints summary + scored groups + critical group details
Usage Guidance
This tool analyzes local GitHub Actions run JSON files and appears to do only that. Before installing/using it, note: (1) SKILL.md shows an example using the 'gh' CLI to collect run JSONs — the script does not call 'gh' itself and the manifest does not list 'gh' as required, so you must either run 'gh' yourself (which requires the GitHub CLI and auth) or collect artifacts by other means; (2) review the RUN_GLOB location you provide so it only contains intended run exports (the script will parse every matching JSON file); (3) no credentials are requested by the skill, and the included script does not perform network calls or exfiltrate data, but if you run the optional 'gh' collection step that will use your GitHub auth — be mindful of that credential scope. If you want higher assurance, run the script against the bundled fixtures first and inspect the output.
Capability Analysis
Type: OpenClaw Skill Name: github-actions-pr-gate-health-audit Version: 1.0.0 The skill is a legitimate utility for auditing GitHub Actions reliability by analyzing local JSON run exports. The bash script (pr-gate-health-audit.sh) safely wraps a Python script that processes data using standard libraries, performs input validation, and lacks any network activity, data exfiltration, or unauthorized execution patterns.
Capability Assessment
✓ Purpose & Capability
Name/description claim to analyze GitHub Actions run JSONs; the included script reads JSON files, computes failure/queue/staleness metrics, and emits text/JSON reports. Required binaries (bash, python3) match the actual implementation. No unrelated credentials or system paths are requested.
ℹ Instruction Scope
SKILL.md documents a convenient step using the 'gh' CLI to export runs (gh run view ...). The runtime script itself only reads local JSON files (RUN_GLOB) and does not invoke the network. The manifest does not declare 'gh' as a required binary or any auth requirement; if you follow the suggested 'gh' collect step, you will need the GitHub CLI and its authentication (not declared). Otherwise, you must supply the run JSON artifacts beforehand.
✓ Install Mechanism
This is instruction-only with an included shell+python script; there is no install spec, no downloads, and nothing will be written to disk beyond reading the JSON artifacts and whatever output the script produces.
✓ Credentials
The skill declares no required environment variables or credentials and the script uses only optional input variables (RUN_GLOB, OUTPUT_FORMAT, thresholds, regex filters). No secrets are requested and the script does not access other env vars or config files.
✓ Persistence & Privilege
always is false and the skill does not request persistent presence or modify agent-wide settings. It does not store credentials or alter other skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-actions-pr-gate-health-audit
  3. After installation, invoke the skill by name or use /github-actions-pr-gate-health-audit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of github-actions-pr-gate-health-audit. - Audits pull-request and merge-queue GitHub Actions reliability using run JSON exports. - Scores CI gate risk based on failure rate, queue latency, and stale-success risk. - Flags and reports gates as warning or critical using configurable thresholds. - Supports text and JSON output for operational dashboards or CI use. - Provides flexible input filtering by event, repo, and workflow.
Metadata
Slug github-actions-pr-gate-health-audit
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 295 downloads so far.

How do I install GitHub Actions PR Gate Health Audit?

Run "/install github-actions-pr-gate-health-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GitHub Actions PR Gate Health Audit free?

Yes, GitHub Actions PR Gate Health Audit is completely free (open-source). You can download, install and use it at no cost.

Which platforms does GitHub Actions PR Gate Health Audit support?

GitHub Actions PR Gate Health Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub Actions PR Gate Health Audit?

It is built and maintained by Daniel Lummis (@daniellummis); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 Comments