Analyze GitHub Actions workflow failures and identify root causes using the gh CLI.
npx skills add https://github.com/natelandau/cc-plugin --skill gha-natelandau
Please help me install this Agent Skill. Skill: gha Source: https://github.com/natelandau/cc-plugin/tree/main/plugins/natelandau-toolkit/skills/gha Command: npx skills add https://github.com/natelandau/cc-plugin --skill gha-natelandau
gh CLI to separate fatal errors from warnings and pinpoint what caused the non-zero exit. - Flakiness Detection: Reviews the past 10-20 runs of the specific failed job to determine whether the failure is one-time or recurring, with a success rate. - Breaking Commit Identification: Bisects run history to find the exact commit where the job started failing, confirmed against subsequent runs. - Existing Fix Check: Searches open pull requests for an existing fix before recommending one. - Use Case: A teammate pings you about a red CI badge on main. You pass the failed run URL and receive a report with the root cause, flakiness assessment, breaking commit, and a recommended fix. ## Quick Start Ask the assistant to investigate the GitHub Actions failure at a specific workflow run URL and recommend a fix.High-intent search queries and answers about installing and using this skill.
Use the gh CLI to read the full logs of the failed run, separating fatal errors from warnings. Look for markers like "failing:" and "fatal:" and the script logic that triggers exit 1, then confirm the cause against the failure logic.
Review the past 10 to 20 runs of the exact job that failed, not the whole workflow. Use gh run list --workflow=<name> to get run ids, then gh run view <run-id> --json jobs to check that job's status and compute its recent success rate.
Identify the first run where the job failed and the last run where it passed, then examine the commits between them. Confirm the breaking commit by verifying the job fails in every run after it and passes in every run before it.
It works with any repository accessible through the authenticated gh CLI, since all analysis uses gh run list, gh run view, and gh pr list. You need gh installed and authenticated with permission to read workflow runs and pull requests.
The investigation searches open pull requests with gh pr list --state open --search using error messages or file names. If a fix PR exists, the report includes its number and link and skips the recommendation step.
aadorianDiagnose and fix failing GitHub Actions checks on a pull request branch.
LedgerHQDiagnose failing CI jobs, inspect logs, and apply iterative fixes until checks pass.
PostalocityMonitor AI model health metrics and diagnose performance issues across environments.
ZHLX2005Diagnose CI/CD failures by triggering and monitoring GitHub Actions workflows with gh CLI.