Agent skill · software engineering · paperclipai
prcheckloop
Iterate on a GitHub PR until latest-head checks are green or a precise blocker is named. Use when a PR still has failing or pending checks after review fixes, including after greploop.
Why this skill is useful
Adds a specific automation script for managing GitHub PR checks that the AI wouldn't reliably generate on its own.
What it needs
Requires gh, jq installed locally. Requires github account access. About 4k tokens when loaded. Last updated 2026-08-07. 75,771 stars on the source repository.
What this skill does
PRCheckloop Get a GitHub PR to a fully green check state, or exit with a concrete blocker. Scope GitHub PRs only. If the repo is GitLab, stop and use check-pr. Focus on checks for the latest PR head SHA, not old commits. Focus on CI/status checks, not review comments or PR template cleanup. If the user also wants review-comment cleanup, pair this with check-pr. Inputs PR number (optional): If not provided, detect the PR for the current branch. Max iterations: default 5. Workflow 1. Identify the PR If no PR number is provided, detect it from the current branch: If needed, switch to the PR branch before making changes. Stop early if: gh is not authenticated there is no PR for the branch the repo is not hosted on GitHub 2. Track the latest head SHA Always work against the current PR head SHA: Ignore failing checks from older SHAs. After every push, refresh HEADSHA and restart the inspection loop. 3. Inventory checks for that SHA Fetch both GitHub check runs and legacy commit status contexts: For a compact PR-level view, this GraphQL payload is useful: 4. Wait for checks to actually run After a new push, checks can take a moment to appear. Poll every 15-30 seconds until one of these is true: checks have appeared and every item is in a terminal state checks have appeared and at least one failed no checks appear after a reasonable wait, usually 2 minutes Treat these as terminal success states: check runs: SUCCESS, NEUTRAL, SKIPPED status contexts: SUCCESS Treat these as pending: check runs: QUEUED, PENDING, WAITING, REQUESTED, INPROGRESS status contexts: PENDING Treat these as failures: check runs: FAILURE, TIMEDOUT, CANCELLED, ACTIONREQUIRED, STARTUPFAILURE, STALE status contexts: FAILURE, ERROR If no checks appear for the latest SHA, inspect .github/workflows/, workflow path filters, and branch protection expectations. If the missing check cannot be caused or fixed from the repo, escalate. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills paperclipai/prcheckloop