pr-shepherd
PR Shepherd
Take the current PR from blocked to ready-to-merge. Read what the base branch actually requires, check the PR against each requirement, fix what code changes can fix, and for anything that needs waiting — CI runs, reviewer replies — register a monitor and hand the watch back to the agent. Every requirement ends the run in exactly one state: already met, fixed, rejected with the reasoning posted, or open with an owner named.
This skill does not loop. One run gathers state, fixes, pushes, arms the monitor, and reports. The agent resumes when the monitor fires.
Merging is not part of the job unless the user says it is. See step 0.
A blocker is something the repository requires, not something a bot said. Read the requirements, then verify each claimed defect against the code — most of all the ones an AI agent wrote.
Scope
Use this skill when the user wants a PR carried to a mergeable state:
- "monitor the PR and fix whatever comes up"
- "get this PR ready to merge"
- "checks are red, sort them out"
- "babysit this PR"
- "why can this PR not merge?"