GitHub Actions Commit Health Audit for Openclaw

A specialized audit tool that identifies specific commits causing repeated GitHub Actions workflow failures to help teams prioritize fixes or rollbacks.

daniellummis
v1.0.0
Mar 7, 2026
0
801
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install github-actions-commit-health-audit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install github-actions-commit-health-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is GitHub Actions Commit Health Audit?

The GitHub Actions Commit Health Audit is a powerful utility designed for teams who need to maintain high CI/CD reliability. By analyzing GitHub Actions run exports, this skill groups performance data by commit SHA and repository to pinpoint exactly which changes are introducing instability. It provides a technical layer of visibility that goes beyond standard run logs, allowing developers to see the aggregate impact of a specific commit across various branches and workflows.

Integrating this into your Openclaw Skills workflow enables proactive infrastructure management. Instead of manually hunting for the cause of intermittent failures, this skill scores the risk of every commit based on failure rates and workflow spread, highlighting hotspots before they derail production deployments.

GitHub Actions Commit Health Audit Use Cases

  • Detecting flaky commits that cause non-deterministic failures across multiple GitHub Actions runs.
  • Automating the identification of high-risk code changes that require immediate revert or rollback.
  • Generating CI health reports for Openclaw Skills dashboards to track repo-wide reliability.
  • Setting up fail-gates in deployment pipelines to block releases when critical commit hotspots are detected.

How GitHub Actions Commit Health Audit Works

  1. Run data is exported from GitHub in JSON format, typically using the gh CLI to capture metadata like headSha and conclusion.
  2. The skill scans a specified directory for these JSON artifacts using a configurable glob pattern.
  3. It groups the collected runs by repository and commit SHA to create a unified view of each commit's performance.
  4. A risk score is calculated for each commit using factors such as failure percentage, total run volume, and the diversity of workflows affected.
  5. The tool evaluates these scores against user-defined warning and critical thresholds.
  6. Finally, it generates a ranked report in either text or JSON format, which can be used by Openclaw Skills to trigger alerts or stop CI pipelines.

GitHub Actions Commit Health Audit Setup

To use this within the Openclaw Skills ecosystem, ensure you have bash and python3 installed. First, collect your GitHub Actions run data:

gh run view <run-id> --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,updatedAt,startedAt,url,repository > artifacts/github-actions/run-<run-id>.json

Then, execute the audit script:

RUN_GLOB='artifacts/github-actions/*.json' MIN_RUNS=3 bash skills/github-actions-commit-health-audit/scripts/commit-health-audit.sh

GitHub Actions Commit Health Audit Data Schema & Taxonomy

The skill processes JSON files representing GitHub Actions runs. The following metadata taxonomy is expected in the input files:

Field Description
headSha The unique commit identifier used for grouping
conclusion The status of the run (success, failure, etc.)
repository The source repo of the run
workflowName The name of the specific CI workflow

The output data provides a summary of total runs, a list of critical commits, and a risk score for each SHA found in the Openclaw Skills audit path.

GitHub Actions Commit Health Audit Advanced Features

  • Regex filtering to include or exclude specific branches, workflows, or repositories during the audit.
  • Configurable risk scoring using FAIL_WARN_PERCENT and FAIL_CRITICAL_PERCENT environment variables.
  • Automated exit codes for CI integration: use FAIL_ON_CRITICAL=1 to break builds when risky commits are detected.
  • JSON output mode for programmatic consumption by other Openclaw Skills or external monitoring tools.
  • Support for offline analysis using bundled fixtures to validate audit logic without live API access.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins bashpython3
Github Stars: 0
forks: 0

Featured*