GitHub Actions SHA Rerun Debt Audit
/install github-actions-sha-rerun-debt-audit
GitHub Actions SHA Rerun Debt Audit
Use this skill to detect commits that trigger repeated GitHub Actions reruns and failed outcomes across multiple workflows.
What this skill does
- Reads GitHub Actions run JSON exports
- Correlates attempt history by run id and latest outcome per run
- Aggregates rerun debt by repository + commit SHA
- Scores risk using rerun rate, failed-run count, workflow spread, and wasted rerun minutes
- Emits severity (
ok,warn,critical) for CI gates
Inputs
Optional:
RUN_GLOB(default:artifacts/github-actions/*.json)TOP_N(default:20)OUTPUT_FORMAT(textorjson, default:text)MIN_RUNS(minimum runs per SHA, default:3)WARN_RERUN_RATE(0..1, default:0.25)CRITICAL_RERUN_RATE(0..1, default:0.45)WARN_FAILED_RUNS(default:2)CRITICAL_FAILED_RUNS(default:4)WARN_WASTED_MINUTES(default:25)CRITICAL_WASTED_MINUTES(default:75)WARN_WORKFLOWS(distinct workflows affected, default:2)CRITICAL_WORKFLOWS(default:4)WORKFLOW_MATCH/WORKFLOW_EXCLUDE(regex, optional)BRANCH_MATCH/BRANCH_EXCLUDE(regex, optional)EVENT_MATCH/EVENT_EXCLUDE(regex, optional)REPO_MATCH/REPO_EXCLUDE(regex, optional)HEAD_SHA_MATCH/HEAD_SHA_EXCLUDE(regex, optional)FAILURE_CONCLUSIONS(comma-separated, default:failure,cancelled,timed_out,startup_failure,action_required)FAIL_ON_CRITICAL(0or1, default:0)
Collect run JSON
gh run view \x3Crun-id> --attempt \x3Cattempt> \
--json databaseId,runAttempt,workflowName,event,headBranch,headSha,conclusion,createdAt,updatedAt,runStartedAt,url,repository \
> artifacts/github-actions/run-\x3Crun-id>-attempt-\x3Cattempt>.json
Run
Text report:
RUN_GLOB='artifacts/github-actions/*.json' \
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh
JSON output + fail gate:
RUN_GLOB='artifacts/github-actions/*.json' \
OUTPUT_FORMAT=json \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh
Run against bundled fixtures:
RUN_GLOB='skills/github-actions-sha-rerun-debt-audit/fixtures/*.json' \
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh
Output contract
- Exit
0in report mode (default) - Exit
1whenFAIL_ON_CRITICAL=1and one or more SHA groups are critical - Text mode prints summary + ranked SHA risk groups
- JSON mode prints summary + ranked groups + critical groups
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-actions-sha-rerun-debt-audit - After installation, invoke the skill by name or use
/github-actions-sha-rerun-debt-audit - Provide required inputs per the skill's parameter spec and get structured output
What is GitHub Actions SHA Rerun Debt Audit?
Audit rerun debt by commit SHA to find commits that repeatedly burn CI minutes across workflows. It is an AI Agent Skill for Claude Code / OpenClaw, with 259 downloads so far.
How do I install GitHub Actions SHA Rerun Debt Audit?
Run "/install github-actions-sha-rerun-debt-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Actions SHA Rerun Debt Audit free?
Yes, GitHub Actions SHA Rerun Debt Audit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does GitHub Actions SHA Rerun Debt Audit support?
GitHub Actions SHA Rerun Debt Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Actions SHA Rerun Debt Audit?
It is built and maintained by Daniel Lummis (@daniellummis); the current version is v1.0.0.