About pr-to-ready
A skill for taking a pull request from review to a readiness assessment. It guides agents through inspecting live PR state, addressing actionable feedback, running checks, and reporting status without merging.
Key features
- 01Inspect live PR details and local Git state
- 02Classify reviewer feedback
- 03Make focused fixes and respond to threads
- 04Run checks and re-check after pushing
- 05Report readiness without merging
Use cases
- 01Triage reviews on an open PR
- 02Resolve actionable review comments
- 03Check readiness before requesting merge
- 04Identify blockers and remaining review items
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ owainlewis/ blueprint --skill pr-to-readyAfter installing, type/pr-to-readyin Claude Code to confirm it loaded.
Details
From the project READMEPR To Ready
- Identify the PR from
$ARGUMENTS, the current branch, or open repo PRs. - Inspect the live PR: diff, commits, checks, reviews, unresolved threads, comments, mergeability, and local git status.
- Classify feedback: actionable, disputed, resolved, outdated, informational, needs-human.
- Fix actionable items, keeping changes small. Push back on disputed items with a comment on the thread explaining why, and do not change the code. Stop for product, security, code-owner, or risk decisions.
- Run the smallest checks that prove the fix, wider checks when shared or user-facing behavior changed.
- Re-check the PR after pushing. Reply on each addressed thread with what changed. Update the linked ticket with proof when accessible.
- Report Ready, Not ready, or Blocked, with changes, checks run, pushed-back items, and remaining items.
- If asked "merge?", answer directly. Never merge.
Rules
- Never merge.
- Push back only with a concrete reason: correctness, scope, or a documented convention. Preference disagreements from a human reviewer go to needs-human, not a rebuttal.
- Do not expand the task for nice-to-have feedback.
- Do not mark ready while required checks fail or actionable feedback remains.
- Trust the live PR state, not stale summaries.
- Do not hide skipped tests, placeholders, partial fixes, or assumptions.
Comments
Markdown supported