fix-ci

Identify the earliest failing GitHub PR CI check and diagnose its root error.

Updated May 18, 2025
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill fix-ci-nthpaul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-ci
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/plugins/cache/cursor-public/cursor-team-kit/d1cdb88a9eb33cf392395c87e3fd76419fc1010e/skills/fix-ci
Command: npx skills add https://github.com/nthpaul/dotfiles --skill fix-ci-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a pull request’s CI is failing, this Skill helps you quickly identify the first actionable error and apply a focused fix so the PR returns to green.

Core Features & Use Cases

  • Pinpoint the failing check by using the output of gh pr checks --json name,bucket,state,workflow,link to locate the specific job that is red.
  • Inspect logs and follow external links to determine the root cause and the command or service that actually failed.
  • Apply the smallest safe change iteratively so each push resolves one actionable failure at a time without unnecessary refactors.

Quick Start

Run fix-ci to examine your PR’s failing checks, identify the first root error from the relevant logs or check link, and apply the smallest safe change, then repeat until CI is green.

Frequently Asked Questions about fix-ci

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

FAQPage Schema
How do I fix failing GitHub Actions checks on a pull request?

To fix failing GitHub Actions checks, use `gh pr checks` to identify the earliest actionable failing job, inspect its logs to diagnose the root error, apply a small safe fix, and re-check until all relevant checks pass.

Why does my pull request CI fail and how do I find the root cause?

Pull request CI fails when specific jobs encounter errors. You can find the root cause by running `gh pr checks --json name,bucket,state,workflow,link`, inspecting the failed job details, and following external links to the relevant logs.

What is the best way to diagnose multiple failing PR checks iteratively?

The best way to diagnose multiple failing PR checks iteratively is to locate the first red job using `gh pr checks` as the source of truth, resolve one actionable failure at a time with minimal changes, and repeat the process until CI is green.

Do I need the GitHub CLI to inspect failed job details for CI debugging?

Yes, you need the GitHub CLI to inspect failed job details for CI debugging, as this Skill requires using `gh pr checks` output as the source of truth to locate the specific job that is red and retrieve its check link.

Can I resolve GitHub Actions failures without unnecessary refactors?

Yes, you can resolve GitHub Actions failures without unnecessary refactors by applying the smallest safe change iteratively, ensuring each push resolves exactly one actionable failure at a time to reach a green build.

When should I avoid applying multiple fixes at once during CI debugging?

You should avoid applying multiple fixes at once during CI debugging when following an iterative PR workflow, because applying the smallest safe change one at a time ensures a minimal-change path back to green without introducing new errors.