github-actions-failure-triage

Diagnose failing GitHub Actions runs and map failures to workflow YAML.

1|1|Updated May 3, 2026

Search Tags:#debugging #github-actions #diagnose #triage #workflows #ci

Ready to run

npx skills add https://github.com/matt-riley/agent-skills --skill github-actions-failure-triage

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: github-actions-failure-triage
Source: https://github.com/matt-riley/agent-skills/tree/main/skills/github-actions-failure-triage
Command: npx skills add https://github.com/matt-riley/agent-skills --skill github-actions-failure-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses why a repository on GitHub Actions has a failing run, job, or check and provides minimal, targeted remediation steps.

Core Features & Use Cases

Diagnose failing GitHub Actions runs and identify the exact failing step, job, or check.
Map the failure to the originating workflow, reusable workflow call, or action version, and propose the smallest safe fix.
Provide an escalation or handoff path when issues involve admin settings, runner health, or policy constraints.

Quick Start

Anchor onto the exact failing surface from logs and propose the smallest, validated change that preserves the rest of the workflow.

Frequently Asked Questions about github-actions-failure-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I diagnose a failing GitHub Actions run from workflow logs?▼

To diagnose a failing GitHub Actions run, you anchor the exact failing step or job from the logs and map the failure back to the originating workflow YAML, reusable workflow call, or action version to classify the issue surface.

What is the best way to fix a failing GitHub Actions workflow check?▼

The best way to fix a failing GitHub Actions workflow check is to propose the smallest justified change that preserves the rest of the workflow, validate the fix with targeted checks, and document the final outcome.

Why does my GitHub Actions reusable workflow call fail and how do I trace it?▼

A GitHub Actions reusable workflow call fails when the originating action version or YAML configuration is misconfigured, requiring you to map the failure from the logs to the exact reusable workflow surface to identify the root cause.

Can I triage GitHub Actions failures involving admin settings or runner health?▼

You can triage GitHub Actions failures involving admin settings, runner health, or policy constraints up to a point, but the Skill provides an escalation or handoff path when issues extend beyond workflow YAML and action versions.

Does this approach work for identifying the exact failing job in a complex CI pipeline?▼

Yes, diagnosing failing GitHub Actions runs involves anchoring onto the exact failing surface from logs, which pinpoints the specific failing job or check within complex CI workflows before proposing remediation steps.