Fix Failing GitHub Actions: Debug CI with gh CLI

What This Skill Does

Debug and fix failing GitHub Actions CI checks on pull requests. Uses gh CLI to inspect check runs, pull logs, identify failure causes, and implement fixes.

When to Use It

• PR checks are failing and you need to understand why
• GitHub Actions workflows are erroring out
• You need to read CI logs without opening the browser
• You want a structured approach to diagnosing CI failures

Workflow

1. Run gh pr checks to see which checks failed
2. Use gh run view to inspect the failed run
3. Pull logs with gh run view --log-failed for targeted output
4. Analyze failure context — test failures, build errors, lint issues
5. Draft a fix plan and implement only after understanding the root cause

Limitations

• External CI providers (Buildkite, CircleCI, etc.) are out of scope — only the dashboard URL is reported
• Cannot modify workflow files in the GitHub Actions runner environment