Download .agents/skills/prcheckloop/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does prcheckloop live?
The publisher keeps it at https://github.com/paperclipai/paperclip.
Which agents can use prcheckloop?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.
>
name: prcheckloop
description: >
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.
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:
check runs: FAILURE, TIMED_OUT, CANCELLED, ACTION_REQUIRED, STARTUP_FAILURE, 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. Investigate failing checks
For GitHub Actions failures, inspect runs and failed logs for the current SHA:
gh run list --commit "$HEAD_SHA" --json databaseId,workflowName,status,conclusion,url,headSha
gh run view <RUN_ID> --json databaseId,name,workflowName,status,conclusion,jobs,url,headSha
gh run view <RUN_ID> --log-failed
For each failing check, classify it:
Failure type
Action
Code/test regression
Reproduce locally, fix, and verify
Lint/type/build mismatch
Run the matching local command from the workflow and fix it
Flake or transient infra issue
Rerun once if evidence supports flakiness
External service/status app failure
Escalate with the details URL and owner guess
Missing secret/permission/branch protection issue
Escalate immediately
Only rerun a failed job once without code changes. Do not loop on reruns.
6. Fix actionable failures
If the failure is actionable from the checked-out code:
Read the workflow or failing command to identify the real gate.
Reproduce locally where reasonable.
Make the smallest correct fix.
Run focused verification first, then broader verification if needed.
Commit in a logical commit.
Push before re-checking the PR.
Do not stop at a local fix. The loop is only complete when the remote PR checks
for the new head SHA are green.
7. Push and repeat
After each fix:
git push
sleep 5
Then refresh the PR metadata, get the new HEAD_SHA, and restart from Step 3.
Exit the loop only when:
all checks for the latest head SHA are green, or
a blocker remains after reasonable repair effort, or
the max iteration count is reached
8. Escalate blockers precisely
If you cannot get the PR green, report:
PR URL
latest head SHA
exact failing or missing check names
details URLs
what you already tried
why it is blocked
who should likely unblock it
the next concrete action
Good blocker examples:
external status app outage
missing GitHub secret or permission
required check name mismatch in branch protection
persistent flake after one rerun
failure needs credentials or infrastructure access you do not have
Output
When the skill completes, report:
PR URL and branch
final head SHA
green/pending/failing check summary
fixes made and verification run
whether changes were pushed
blocker summary if not fully green
Notes
This skill is intentionally narrower than check-pr: it is a repair loop for
PR checks.
This skill complements greploop: Greptile can be perfect while CI is still
red.
How do I install prcheckloop?
Download .agents/skills/prcheckloop/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does prcheckloop live?
The publisher keeps it at https://github.com/paperclipai/paperclip.
Which agents can use prcheckloop?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.