debug-github-ci

Debug GitHub Actions CI failures using gh CLI to inspect runs, logs, and workflows.

38|5|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/ericmjl/skills --skill debug-github-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-github-ci
Source: https://github.com/ericmjl/skills/tree/main/skills/debug-github-ci
Command: npx skills add https://github.com/ericmjl/skills --skill debug-github-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Actions and CI workflows can fail without clear guidance; this skill guides systematic debugging using the gh CLI to identify, reproduce, and fix issues efficiently.

Core Features & Use Cases

  • Watch CI checks in real time with gh pr checks --watch to monitor progress and catch failures early.
  • Inspect failures by fetching run metadata and logs for failed jobs to pinpoint root causes.
  • Reproduce and validate fixes locally by checking out the same commit and rerunning workflows to verify changes.

Quick Start

Watch CI checks with gh pr checks --watch --interval 5, then inspect a failing run with gh run view and reproduce fixes locally.

Frequently Asked Questions about debug-github-ci

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

FAQPage Schema
How do I debug GitHub Actions CI failures using the gh CLI?

Debug GitHub Actions CI failures by using gh CLI commands like gh run view to fetch run metadata and inspect failed job logs, pinpointing the exact failing steps to identify root causes efficiently.

How can I watch GitHub PR checks in real time to catch CI failures early?

Watch GitHub PR checks by running the command gh pr checks --watch --interval 5, which continuously monitors CI progress and surfaces workflow failures immediately as they occur during the run.

What is the best way to reproduce a GitHub Actions failure locally?

Reproduce a GitHub Actions failure locally by checking out the exact commit that triggered the CI run and rerunning the workflow commands locally to validate your environment and verify potential fixes before pushing changes.

Can I diagnose GitHub CI workflow failures without leaving the command line?

Yes, you can diagnose GitHub CI workflow failures entirely from the command line using the gh CLI to view run details, fetch logs for failed jobs, and systematically inspect workflows without navigating the web interface.

Do I need to install any dependencies to reproduce CI fixes with the gh CLI?

You only need the gh CLI installed and authenticated to reproduce CI fixes, as the workflow uses native commands like gh pr checks and gh run view to inspect runs and guide local reproduction without requiring external dependencies.