GitHub Actions Failure Owner Audit
/install github-actions-failure-owner-audit
GitHub Actions Failure Owner Audit
Use this skill to attribute GitHub Actions failures to owners (actors) so teams can route CI stabilization work by impact instead of guesswork.
What this skill does
- Reads one or more GitHub Actions run JSON exports (
gh apioutput or per-run JSON files) - Focuses on failure-like conclusions by default (
failure,cancelled,timed_out,action_required,startup_failure) - Groups by repository + actor (or repository + actor + workflow)
- Scores hotspots by failed run counts and total failed runtime minutes
- Supports text and JSON output for triage meetings and automation
Inputs
Optional:
RUN_GLOB(default:artifacts/github-actions-runs/*.json)TOP_N(default:20)OUTPUT_FORMAT(textorjson, default:text)GROUP_BY(actor,actor-workflow,owner, orowner-workflow, default:actor)OWNER_MAP_FILE(optional JSON mapping file to map actor regex → owner/team)WARN_FAILURE_RUNS(default:3)CRITICAL_FAILURE_RUNS(default:6)WARN_FAILURE_MINUTES(default:30)CRITICAL_FAILURE_MINUTES(default:90)FAIL_ON_CRITICAL(0or1, default:0)REPO_MATCH/REPO_EXCLUDE(regex, optional)WORKFLOW_MATCH/WORKFLOW_EXCLUDE(regex, optional)BRANCH_MATCH/BRANCH_EXCLUDE(regex, optional)ACTOR_MATCH/ACTOR_EXCLUDE(regex, optional)CONCLUSION_MATCH/CONCLUSION_EXCLUDE(regex, optional)
Collect run JSON
Single repository paginated export:
gh api repos/\x3Cowner>/\x3Crepo>/actions/runs --paginate \
> artifacts/github-actions-runs/\x3Cowner>-\x3Crepo>.json
Run
Default ownership triage:
RUN_GLOB='artifacts/github-actions-runs/*.json' \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
Workflow-scoped ownership triage with stricter thresholds:
RUN_GLOB='artifacts/github-actions-runs/*.json' \
GROUP_BY='actor-workflow' \
WARN_FAILURE_RUNS=2 \
CRITICAL_FAILURE_RUNS=4 \
WARN_FAILURE_MINUTES=20 \
CRITICAL_FAILURE_MINUTES=60 \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
JSON output for dashboards/alerts:
RUN_GLOB='artifacts/github-actions-runs/*.json' \
OUTPUT_FORMAT='json' \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
Filter to a repo and release branches only:
RUN_GLOB='artifacts/github-actions-runs/*.json' \
REPO_MATCH='^flowcreatebot/' \
BRANCH_MATCH='^(main|release/)' \
ACTOR_EXCLUDE='(dependabot|renovate)' \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
Run with bundled fixtures:
RUN_GLOB='skills/github-actions-failure-owner-audit/fixtures/*.json' \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
Owner/team mapping (first matching regex wins):
{
"^dependabot\\[bot]$": "automation",
"^renovate\\[bot]$": "automation",
"^alice$": "platform"
}
RUN_GLOB='artifacts/github-actions-runs/*.json' \
GROUP_BY='owner-workflow' \
OWNER_MAP_FILE='skills/github-actions-failure-owner-audit/examples/owner-map.sample.json' \
bash skills/github-actions-failure-owner-audit/scripts/failure-owner-audit.sh
Output contract
- Exit
0in reporting mode (default) - Exit
1ifFAIL_ON_CRITICAL=1and at least one ownership group is critical - In
textmode: prints summary and top ownership hotspots - In
jsonmode: prints summary, top groups, all groups, and critical groups
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-actions-failure-owner-audit - After installation, invoke the skill by name or use
/github-actions-failure-owner-audit - Provide required inputs per the skill's parameter spec and get structured output
What is GitHub Actions Failure Owner Audit?
Audit failing GitHub Actions runs by actor ownership to expose who/workflow combinations generate the most CI noise and wasted minutes. It is an AI Agent Skill for Claude Code / OpenClaw, with 309 downloads so far.
How do I install GitHub Actions Failure Owner Audit?
Run "/install github-actions-failure-owner-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Actions Failure Owner Audit free?
Yes, GitHub Actions Failure Owner Audit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does GitHub Actions Failure Owner Audit support?
GitHub Actions Failure Owner Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Actions Failure Owner Audit?
It is built and maintained by Daniel Lummis (@daniellummis); the current version is v1.2.0.