gh-debug

Fetch and analyze GitHub Actions workflow logs to diagnose failures.

7.5k|1.8k|Updated Nov 10, 2013
One-click install
npx skills add https://github.com/FastLED/FastLED --skill gh-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-debug
Source: https://github.com/FastLED/FastLED/tree/main/.claude/skills/gh-debug
Command: npx skills add https://github.com/FastLED/FastLED --skill gh-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses GitHub Actions workflow failures by fetching and analyzing their logs to identify root causes.

Core Features & Use Cases

  • Fetches workflow logs for a failed or flaky run and parses errors
  • Generates a clear diagnostic report with actionable next steps
  • Supports both automated analysis via a Python script and manual inspection

Quick Start

Invoke the gh_debug.py script with a run-id or workflow URL to start diagnosing the failure.

Frequently Asked Questions about gh-debug

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

FAQPage Schema
How do I debug GitHub Actions workflow failures from run logs?

Debug GitHub Actions workflow failures by fetching and analyzing run logs to identify root causes. The diagnostic process streams logs, filters errors, and generates a report with targeted error context and actionable next steps.

What is the best way to diagnose flaky CI/CD pipelines?

Diagnose flaky CI/CD pipelines by fetching and parsing workflow logs for the failed run. The analyzer filters errors, caps results, and produces a clear diagnostic report with actionable next steps to resolve intermittent pipeline failures.

How do I analyze GitHub Actions logs using a Python script?

Analyze GitHub Actions logs by invoking a Python-based log analyzer script with a run-id or workflow URL. The script streams workflow logs, filters errors, and can cap results to provide targeted error diagnostics for failed runs.

Can I manually inspect GitHub Actions logs if automated analysis fails?

Manual inspection of GitHub Actions logs is supported as a fallback workflow. If the primary automated Python log analyzer fails to diagnose the workflow failure, you can manually inspect the fetched logs to identify the root cause.

Why does my GitHub Actions workflow fail and how do I find the error?

GitHub Actions workflow failures are identified by fetching and analyzing workflow logs to parse errors. The log analyzer streams the logs, filters errors, and generates a diagnostic report with targeted error context and actionable next steps.

Does this log analysis approach work for any failed GitHub Actions run?

Yes, this log analysis approach applies to failed runs and flaky pipelines across GitHub Actions workflows. It fetches the specific workflow logs for the run-id provided and applies error diagnostics to identify the root cause.