loop-on-ci

Loop on GitHub pull request checks until all required checks pass.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you monitor GitHub pull request checks and systematically fix failures until all required checks pass, so you don’t guess what’s broken or what’s still pending.

Core Features & Use Cases

  • Track the full set of PR-attached checks: Uses gh pr checks as the source of truth for checks tied to the pull request (including non–GitHub Actions signals).
  • Diagnose before you iterate: Checks the current PR state, prioritizes already-failing checks, and only then addresses pending ones.
  • Watch efficiently with targeted retries: Uses watch mode with fail-fast to reduce wait time, and re-checks the entire PR check set after each push.
  • Use real failure evidence: Pulls logs from the failing check’s linked GitHub Actions run when applicable.

Quick Start

Tell the assistant to loop on CI for the current branch’s pull request by using gh pr checks as the truth source and applying fixes until the PR reports all required checks as green.

Frequently Asked Questions about loop-on-ci

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

FAQPage Schema
How do I automatically fix failing GitHub pull request checks?

To fix failing GitHub pull request checks, you can loop on CI by using `gh pr checks` as the source of truth, prioritizing already-failing checks over pending ones, and re-validating the entire PR check set after each push until all required checks are green.

How do I use gh pr checks to monitor CI failures?

You use `gh pr checks` to monitor CI failures by inspecting its JSON output to track the full set of PR-attached checks, using watch mode with fail-fast to reduce wait time, and pulling logs from linked GitHub Actions runs to apply targeted fixes.

What is the best way to debug CI failures without guessing what is broken?

The best way to debug CI failures without guessing is to systematically diagnose the current PR state, pull real failure evidence from the linked GitHub Actions run using `gh run view --log-failed`, and apply scoped fixes before re-checking the PR.

Does this CI debugging approach work with non-GitHub Actions checks?

Yes, this CI debugging approach works with non-GitHub Actions checks because it uses `gh pr checks` as the source of truth for all checks tied to the pull request, including non-GitHub Actions signals, rather than relying solely on GitHub Actions run data.

How do I prioritize which CI checks to fix first on a pull request?

To prioritize which CI checks to fix first, you diagnose the current PR state and immediately address already-failing checks before waiting on pending ones, using watch mode with fail-fast to reduce overall wait time during the debugging loop.

What are the limitations of using gh pr checks for PR debugging?

A limitation of using `gh pr checks` for PR debugging is that you must enforce guardrails to keep fixes scoped and avoid bypassing verification, and while it tracks all PR-attached checks, pulling detailed failure logs is only applicable when checks are linked to GitHub Actions runs.