A monitoring skill designed to detect and alert on GitHub Actions workflows that remain in queued or in-progress states for excessive periods.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install github-actions-stuck-run-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install github-actions-stuck-run-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 Stuck Run Audit?
The GitHub Actions Stuck Run Audit is a technical utility integrated into the Openclaw Skills ecosystem to provide visibility into workflow execution health. It analyzes exported GitHub Actions run metadata to identify "stale" runs—those that have not reached a terminal state within expected timeframes. By quantifying stuck-run volume and stuck-rate percentages, it allows teams to identify resource contention, runner availability issues, or configuration errors before they quietly halt the delivery pipeline.
GitHub Actions Stuck Run Audit Use Cases
- Monitoring high-concurrency CI environments for workflow queuing bottlenecks.
- Auditing repository health to ensure runners are picking up jobs as expected.
- Implementing automated CI/CD quality gates that fail when too many critical workflows are stuck.
- Identifying long-running jobs that consume excess minutes without progressing.
How GitHub Actions Stuck Run Audit Works
- Run data is exported from the GitHub CLI in JSON format for the targeted workflows.
- The skill processes these JSON files using a configurable glob pattern to aggregate run metadata.
- It filters for non-terminal statuses such as queued, in_progress, pending, or waiting.
- It calculates the age and risk score of each group based on user-defined minute and volume thresholds.
- It outputs a ranked severity report (ok, warn, or critical) and optionally triggers a non-zero exit code for automation.
GitHub Actions Stuck Run Audit Setup
Ensure you have the GitHub CLI, bash, and python3 installed on your system.
First, export your run data:
gh run view <run-id> \
--json databaseId,workflowName,event,headBranch,status,conclusion,createdAt,runStartedAt,updatedAt,url,repository \
> artifacts/github-actions/run-<run-id>.json
Then, execute the audit using Openclaw Skills scripts:
RUN_GLOB='artifacts/github-actions/*.json' \
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh
GitHub Actions Stuck Run Audit Data Schema & Taxonomy
The skill consumes JSON metadata produced by the GitHub CLI. It organizes results into a hierarchy based on the chosen grouping strategy.
| Input Parameter | Default Value | Description |
|---|---|---|
GROUP_BY |
repo-workflow |
Aggregation level (repo, repo-workflow, or repo-workflow-branch) |
STUCK_STATUSES |
queued,in_progress... |
List of non-terminal statuses to monitor |
WARN_STUCK_MINUTES |
45 |
Minutes before a run is flagged as a warning |
CRITICAL_STUCK_MINUTES |
120 |
Minutes before a run is flagged as critical |
GitHub Actions Stuck Run Audit Advanced Features
- Support for regex-based filtering (match or exclude) for repositories, branches, events, and specific workflows.
- Deterministic replay capabilities using
NOW_ISOtimestamp overrides for historical auditing. - Highly configurable risk scoring based on both raw volume and percentage-based stuck rates.
- Dual output modes providing either human-readable text summaries or structured JSON for downstream automation.
SKILL.md
Loading
Related Openclaw Skills
GitHub Actions Step Flake Audit
Identify and rank flaky GitHub Actions steps by analyzing success and failure outcomes across multiple workflow runs.
GitHub Actions SHA Rerun Debt Audit
Audit GitHub Actions rerun debt to identify and eliminate commit-level CI inefficiencies.
GitHub Actions Self-Hosted Risk Audit
A specialized security auditing tool for identifying high-risk configurations in GitHub Actions workflows utilizing self-hosted runners.
GitHub Actions Secret Exposure Audit
An automated auditing tool to identify and mitigate secret exposure risks within GitHub Actions workflow configurations.
GitHub Actions Timeout Risk Audit
Proactively identify and fix near-timeout GitHub Actions jobs before they break your CI pipeline.
GitHub Actions Trigger Health Audit
A diagnostic tool for identifying flaky GitHub Actions workflows by analyzing failure rates across specific trigger events and repositories.
METADATA
Featured*
