gh-run-failure

Analyze GitHub Actions run failures by inspecting job outcomes and step logs.

11|2|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/bkircher/skills --skill gh-run-failure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-run-failure
Source: https://github.com/bkircher/skills/tree/main/gh-run-failure
Command: npx skills add https://github.com/bkircher/skills --skill gh-run-failure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you quickly diagnose and understand why your GitHub Actions pipelines or jobs are failing, saving you time and frustration during development and deployment.

Core Features & Use Cases

  • Identify Failures: Pinpoint specific failed jobs and steps within a GitHub Actions run.
  • Analyze Logs: View detailed logs for failed jobs and steps to understand the root cause.
  • Compare Runs: Compare the commit messages of a failed run against the latest successful run to identify code changes that might have introduced the failure.
  • Artifact Management: Download artifacts from failed runs for deeper inspection.

Quick Start

Use the gh-run-failure skill to analyze the most recent failed GitHub run for the current branch.

Frequently Asked Questions about gh-run-failure

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

FAQPage Schema
How do I debug GitHub Actions pipeline failures?

To debug GitHub Actions pipeline failures, you can analyze run statuses, inspect specific job outcomes, and review detailed step logs to pinpoint the root cause of the error.

How do I find breaking changes in a failed GitHub Actions run?

Find breaking changes in a failed GitHub Actions run by comparing the commit messages of the failed run against the latest successful run to identify code changes that introduced the failure.

Do I need the gh CLI tool to analyze GitHub CI/CD errors?

Yes, you need the gh CLI tool installed and authenticated to analyze GitHub CI/CD errors, as the skill relies on it to retrieve run statuses and job logs.

Can I download artifacts from failed GitHub Actions jobs?

Yes, you can download artifacts from failed GitHub Actions jobs to perform deeper inspection of build outputs and test data during troubleshooting.

What is the best way to troubleshoot a failing GitHub Actions workflow?

The best way to troubleshoot a failing GitHub Actions workflow is to automate the inspection of run statuses and step logs, which helps quickly identify failed jobs and retrieve detailed failure information for remediation.