GitHub Actions Trigger Health Audit
/install github-actions-trigger-health-audit
GitHub Actions Trigger Health Audit
Use this skill to find which GitHub Actions trigger events are driving the highest failure rates.
What this skill does
- Reads one or more GitHub Actions run JSON exports
- Groups runs by repository + event + workflow
- Calculates failure/cancel/timeout rates and average runtime
- Flags warning/critical hotspots based on configurable failure-rate thresholds
- Supports regex include/exclude filters for repo, workflow, and event
- Emits text or JSON output for dashboards and automation gates
Inputs
Optional:
RUN_GLOB(default:artifacts/github-actions/*.json)TOP_N(default:20)OUTPUT_FORMAT(textorjson, default:text)MIN_RUNS(default:2) — skip low-sample groupsFAIL_WARN_PERCENT(default:20)FAIL_CRITICAL_PERCENT(default:40)FAIL_ON_CRITICAL(0or1, default:0)WORKFLOW_MATCH(regex, optional)WORKFLOW_EXCLUDE(regex, optional)EVENT_MATCH(regex, optional)EVENT_EXCLUDE(regex, optional)REPO_MATCH(regex, optional)REPO_EXCLUDE(regex, optional)
Collect run JSON
gh run view \x3Crun-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,updatedAt,startedAt,url,repository \
> artifacts/github-actions/run-\x3Crun-id>.json
Run
Text report:
RUN_GLOB='artifacts/github-actions/*.json' \
MIN_RUNS=3 \
FAIL_WARN_PERCENT=25 \
FAIL_CRITICAL_PERCENT=50 \
bash skills/github-actions-trigger-health-audit/scripts/trigger-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-trigger-health-audit/scripts/trigger-health-audit.sh
Run with bundled fixtures:
RUN_GLOB='skills/github-actions-trigger-health-audit/fixtures/*.json' \
bash skills/github-actions-trigger-health-audit/scripts/trigger-health-audit.sh
Output contract
- Exit
0in report mode (default) - Exit
1whenFAIL_ON_CRITICAL=1and any group meets critical threshold - Text mode prints summary + ranked trigger health hotspots
- JSON mode prints summary + grouped metrics + critical group details
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-actions-trigger-health-audit - After installation, invoke the skill by name or use
/github-actions-trigger-health-audit - Provide required inputs per the skill's parameter spec and get structured output
What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 352 downloads so far.
How do I install GitHub Actions Trigger Health Audit?
Run "/install github-actions-trigger-health-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Actions Trigger Health Audit free?
Yes, GitHub Actions Trigger Health Audit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does GitHub Actions Trigger Health Audit support?
GitHub Actions Trigger Health Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Actions Trigger Health Audit?
It is built and maintained by Daniel Lummis (@daniellummis); the current version is v1.0.0.