← Back to Skills Marketplace
daniellummis

GitHub Actions Failure Hour Audit

by Daniel Lummis · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
248
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install github-actions-failure-hour-audit
Description
Audit GitHub Actions failure timing by day/hour to surface recurring outage windows and staffing hotspots.
README (SKILL.md)

GitHub Actions Failure Hour Audit

Use this skill to identify when failures cluster so teams can target flaky time windows and on-call coverage.

What this skill does

  • Reads one or more GitHub Actions workflow run JSON exports
  • Keeps only failure-like conclusions (failure, cancelled, timed_out, action_required, startup_failure)
  • Buckets failures into day/hour windows (with optional timezone offset)
  • Ranks windows by severity using failure-run thresholds
  • Emits text or JSON output for dashboards or CI gates

Inputs

Optional:

  • RUN_GLOB (default: artifacts/github-actions/*.json)
  • TOP_N (default: 24)
  • OUTPUT_FORMAT (text or json, default: text)
  • WARN_FAILURE_RUNS (default: 3)
  • CRITICAL_FAILURE_RUNS (default: 6)
  • FAIL_ON_CRITICAL (0 or 1, default: 0)
  • TZ_OFFSET_HOURS (default: 0) — integer timezone shift from UTC, between -23 and 23
  • WORKFLOW_MATCH, WORKFLOW_EXCLUDE (regex, optional)
  • BRANCH_MATCH, BRANCH_EXCLUDE (regex, optional)
  • REPO_MATCH, REPO_EXCLUDE (regex, optional)

Collect run JSON

gh run view \x3Crun-id> --json databaseId,workflowName,headBranch,conclusion,createdAt,updatedAt,url,repository \
  > artifacts/github-actions/run-\x3Crun-id>.json

Run

Text report:

RUN_GLOB='artifacts/github-actions/*.json' \
WARN_FAILURE_RUNS=3 \
CRITICAL_FAILURE_RUNS=6 \
TZ_OFFSET_HOURS=7 \
bash skills/github-actions-failure-hour-audit/scripts/failure-hour-audit.sh

JSON output + fail gate:

RUN_GLOB='artifacts/github-actions/*.json' \
OUTPUT_FORMAT=json \
FAIL_ON_CRITICAL=1 \
bash skills/github-actions-failure-hour-audit/scripts/failure-hour-audit.sh

Output contract

  • Exit 0 in reporting mode
  • Exit 1 when FAIL_ON_CRITICAL=1 and one or more critical windows are found
  • Text output includes summary and top windows by severity
  • JSON output includes summary, ranked windows, and critical_windows
Usage Guidance
This script analyzes local GitHub Actions JSON exports — run it locally against a directory of exported run JSONs (default: artifacts/github-actions/*.json). The skill itself needs only bash and python3. SKILL.md shows how to collect runs with the GitHub CLI ('gh run view ...'), but 'gh' is not declared as a required binary and is not invoked by the script; if you use that collection step, 'gh' will use your GitHub auth (tokens) outside this skill. The script prints sample run URLs and repo names (it does not transmit them), so avoid running it in environments where printed output is automatically uploaded to an untrusted endpoint. If you plan to run this in CI, ensure RUN_GLOB matches only intended files and review outputs before storing or sharing. If you want the documentation to match runtime behavior, either install/declare 'gh' separately or remove the gh usage example from SKILL.md.
Capability Analysis
Type: OpenClaw Skill Name: github-actions-failure-hour-audit Version: 1.0.0 The skill is a utility for auditing GitHub Actions failure patterns by analyzing local JSON artifacts. It uses a bash wrapper for an embedded Python script (scripts/failure-hour-audit.sh) to process data and generate reports. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the script correctly validates inputs and handles file processing through standard Python libraries.
Capability Assessment
ℹ Purpose & Capability
The name/description match the implementation: the included bash+python script scans local GitHub Actions run JSON files, filters failures, buckets by day/hour, ranks windows, and emits text/JSON. One minor mismatch: SKILL.md shows an example 'gh run view ... > artifacts/..' to collect run JSONs, but the skill metadata/bins do not list the GitHub CLI ('gh'). That is a documentation/inventory inconsistency (the script itself does not invoke 'gh').
✓ Instruction Scope
Runtime instructions and the script operate only on local JSON files matched by RUN_GLOB and environment-configurable filters. The script reads file contents, computes metrics, and prints text/JSON; it does not perform network calls, modify system configuration, or access unrelated files. The only scope extension is the SKILL.md example which instructs the user to use 'gh' to fetch run JSONs (a user action), but the skill does not itself reach out to external endpoints.
✓ Install Mechanism
No install spec — instruction-only with a shipped script — so nothing is downloaded or written by an installer. This is low-risk. (As noted, if you plan to use SKILL.md's gh example you must have the gh CLI installed separately; the installer does not provide it.)
ℹ Credentials
The skill requires only bash and python3 (declared). It lists no required environment variables or credentials. Be aware: the SKILL.md recommends using the GitHub CLI to export run JSONs; that step uses the user's gh authentication (outside this skill) but is not required by the script. The script does include sample run URLs and repo names in its output (these are derived from input JSONs and are not transmitted elsewhere by the script).
✓ Persistence & Privilege
The skill does not request permanent presence (always:false), does not modify other skills or system-wide settings, and only reads inputs and writes to stdout/exit codes. It does not persist credentials or alter agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-actions-failure-hour-audit
  3. After installation, invoke the skill by name or use /github-actions-failure-hour-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 Failure Hour Audit. - Audits GitHub Actions workflow run failures by hour/day, supporting timezone offset - Supports filtering by workflow, branch, and repository via regex - Buckets and ranks failure windows by severity thresholds - Outputs in text or JSON for dashboards or CI checks - Configurable fail gate on critical windows - Accepts customizable input variables for flexible usage
Metadata
Slug github-actions-failure-hour-audit
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is GitHub Actions Failure Hour Audit?

Audit GitHub Actions failure timing by day/hour to surface recurring outage windows and staffing hotspots. It is an AI Agent Skill for Claude Code / OpenClaw, with 248 downloads so far.

How do I install GitHub Actions Failure Hour Audit?

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

Is GitHub Actions Failure Hour Audit free?

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

Which platforms does GitHub Actions Failure Hour Audit support?

GitHub Actions Failure Hour Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub Actions Failure Hour 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...
⬇ 463283 · 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.
⬇ 259410 · 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...
⬇ 200423 · 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.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments