How do I install the Github Actions Stuck Run Audit skill?

Run npx skillmds@latest add dvcrn/github-actions-stuck-run-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github Actions Stuck Run Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github Actions Stuck Run Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github Actions Stuck Run Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github Actions Stuck Run Audit?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github Actions Stuck Run Audit by dvcrn

Name: Github Actions Stuck Run Audit
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

GitHub Actions Stuck Run Audit

Use this skill to catch workflows that are stuck in queued/in-progress states for too long.

What this skill does

Reads GitHub Actions run JSON exports
Detects stale runs in non-terminal statuses (queued, in_progress, etc.)
Aggregates stuck risk by repo/workflow (or repo/branch)
Scores severity with stuck-age, stuck-run volume, and stuck-rate thresholds
Emits ok / warn / critical and can fail CI gates

Inputs

Optional:

RUN_GLOB (default: artifacts/github-actions/*.json)
TOP_N (default: 20)
OUTPUT_FORMAT (text or json, default: text)
GROUP_BY (repo, repo-workflow, repo-workflow-branch; default: repo-workflow)
NOW_ISO (optional ISO timestamp override for deterministic replay)
STUCK_STATUSES (comma list, default: queued,in_progress,pending,waiting,requested)
WARN_STUCK_MINUTES (default: 45)
CRITICAL_STUCK_MINUTES (default: 120)
WARN_STUCK_RUNS (default: 2)
CRITICAL_STUCK_RUNS (default: 4)
WARN_STUCK_RATE (0..1, default: 0.2)
CRITICAL_STUCK_RATE (0..1, default: 0.45)
MIN_RUNS (default: 1)
WORKFLOW_MATCH / WORKFLOW_EXCLUDE (regex, optional)
BRANCH_MATCH / BRANCH_EXCLUDE (regex, optional)
EVENT_MATCH / EVENT_EXCLUDE (regex, optional)
REPO_MATCH / REPO_EXCLUDE (regex, optional)
STATUS_MATCH / STATUS_EXCLUDE (regex, optional)
FAIL_ON_CRITICAL (0 or 1, default: 0)

Collect run JSON

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

Run

Text report:

RUN_GLOB='artifacts/github-actions/*.json' \
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh

JSON output + fail gate:

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

Run against bundled fixtures:

NOW_ISO='2026-03-08T00:00:00Z' \
RUN_GLOB='skills/github-actions-stuck-run-audit/fixtures/*.json' \
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh

Output contract

Exit 0 in report mode (default)
Exit 1 when FAIL_ON_CRITICAL=1 and one or more groups are critical
Text mode prints summary + ranked stuck-risk groups
JSON mode prints summary + ranked groups + critical groups

---name: github-actions-stuck-run-auditdescription: Detect stale queued/in-progress GitHub Actions runs before they quietly block delivery.---# GitHub Actions Stuck Run AuditUse this skill to catch workflows that are stuck in queued/in-progress states for too long.## What this skill does- Reads GitHub Actions run JSON exports- Detects stale runs in non-terminal statuses (`queued`, `in_progress`, etc.)- Aggregates stuck risk by repo/workflow (or repo/branch)- Scores severity with stuck-age, stuck-run volume, and stuck-rate thresholds- Emits `ok` / `warn` / `critical` and can fail CI gates## InputsOptional:- `RUN_GLOB` (default: `artifacts/github-actions/*.json`)- `TOP_N` (default: `20`)- `OUTPUT_FORMAT` (`text` or `json`, default: `text`)- `GROUP_BY` (`repo`, `repo-workflow`, `repo-workflow-branch`; default: `repo-workflow`)- `NOW_ISO` (optional ISO timestamp override for deterministic replay)- `STUCK_STATUSES` (comma list, default: `queued,in_progress,pending,waiting,requested`)- `WARN_STUCK_MINUTES` (default: `45`)- `CRITICAL_STUCK_MINUTES` (default: `120`)- `WARN_STUCK_RUNS` (default: `2`)- `CRITICAL_STUCK_RUNS` (default: `4`)- `WARN_STUCK_RATE` (0..1, default: `0.2`)- `CRITICAL_STUCK_RATE` (0..1, default: `0.45`)- `MIN_RUNS` (default: `1`)- `WORKFLOW_MATCH` / `WORKFLOW_EXCLUDE` (regex, optional)- `BRANCH_MATCH` / `BRANCH_EXCLUDE` (regex, optional)- `EVENT_MATCH` / `EVENT_EXCLUDE` (regex, optional)- `REPO_MATCH` / `REPO_EXCLUDE` (regex, optional)- `STATUS_MATCH` / `STATUS_EXCLUDE` (regex, optional)- `FAIL_ON_CRITICAL` (`0` or `1`, default: `0`)## Collect run JSON```bashgh run view <run-id> \ --json databaseId,workflowName,event,headBranch,status,conclusion,createdAt,runStartedAt,updatedAt,url,repository \ > artifacts/github-actions/run-<run-id>.json```## RunText report:```bashRUN_GLOB='artifacts/github-actions/*.json' \bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh```JSON output + fail gate:```bashRUN_GLOB='artifacts/github-actions/*.json' \OUTPUT_FORMAT=json \FAIL_ON_CRITICAL=1 \bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh```Run against bundled fixtures:```bashNOW_ISO='2026-03-08T00:00:00Z' \RUN_GLOB='skills/github-actions-stuck-run-audit/fixtures/*.json' \bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh```## Output contract- Exit `0` in report mode (default)- Exit `1` when `FAIL_ON_CRITICAL=1` and one or more groups are critical- Text mode prints summary + ranked stuck-risk groups- JSON mode prints summary + ranked groups + critical groups

Frequently asked questions

Github Actions Stuck Run Audit