prcheckloop

Automate GitHub pull request checks to green via iterative fixes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Joaoha/xenon-maas --skill prcheckloop-joaoha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prcheckloop
Source: https://github.com/Joaoha/xenon-maas/tree/main/.agents/skills/prcheckloop
Command: npx skills add https://github.com/Joaoha/xenon-maas --skill prcheckloop-joaoha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iteratively gets a GitHub pull request's checks green. Detects the PR for the current branch or uses a provided PR number, waits for every check on the latest head SHA to appear and finish, investigates failing checks, fixes actionable code or test issues, pushes, and repeats. Escalates with a precise blocker when failures are external, flaky, or not safely fixable. Use when a PR still has unsuccessful checks after review fixes, including after greploop.

Core Features & Use Cases

  • PR identification: select PR by number or current branch and lock to the latest head SHA.
  • Check monitoring: wait for CI/status checks to complete, handle pending/failed states, and re-check after fixes.
  • Iterative repair loop: diagnose failures, implement minimal changes, push, and loop until green.
  • Escalation and blockers: provide precise blocker details when issues are external or irrecoverable.

Quick Start

Provide the target PR number or run in the repository to start repairing checks until all are green.

Frequently Asked Questions about prcheckloop

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

FAQPage Schema
How do I automate fixing failing GitHub pull request checks?

You can automate fixing GitHub pull request checks by using a tool that monitors the latest PR head SHA, waits for all checks to finish, investigates failures, applies code fixes, and repeats until green. This loop handles pending and failed states automatically.

What is the best way to get a PR to a fully green check state after review fixes?

The best way to get a PR to a fully green check state is an iterative repair loop that diagnoses failing checks, implements minimal code changes, pushes the fixes, and re-checks the status until all checks pass or a blocker is escalated.

Can I repair CI checks for a GitHub repository using just a branch name?

Yes, you can repair CI checks using a branch name. The process detects the pull request for the current branch and locks onto the latest head SHA, or you can directly provide a PR number to target the specific pull request for check monitoring.

What happens when a pull request has external or flaky check failures that cannot be fixed?

When a pull request has external or flaky check failures that cannot be safely fixed, the process escalates with a precise blocker. This escalation provides detailed information about why the issue is irrecoverable or external, halting the repair loop.

Does the automated PR check repair work with both check-runs and status contexts on GitHub?

Yes, the automated PR check repair works with both check-runs and status contexts on GitHub. It monitors all checks on the latest head SHA, waits for them to complete, and handles both pending and failed states before applying fixes.