Overview

gh pr ready marks a draft PR as ready for review or converts it back to draft using the gh CLI. It accepts a PR number, URL, or branch, or defaults to the current branch PR when no argument is provided. This streamlines status changes during code review.

How This Skill Works

The command first verifies authentication via gh --version and gh auth status, then executes gh pr ready <target> or gh pr ready <target> --undo. If no target is provided, it targets the PR for the current branch.

When to Use It

• You want to mark a draft PR as ready for review.
• You need to convert an already ready PR back to draft (--undo).
• You want to operate on a PR identified by number, URL, or branch.
• You're working on the current branch and want to affect its PR without specifying an ID.
• You’re scripting a PR status change in automation and need a simple ready/undo command.

Quick Start

1. Step 1: Verify auth: gh --version and gh auth status
2. Step 2: Mark a specific PR as ready: gh pr ready 123
3. Step 3: Or undo to draft: gh pr ready 123 --undo (or gh pr ready --undo for current branch)

Best Practices

• Confirm the target PR (number, URL, or branch) before running gh pr ready.
• Use --undo to revert a ready PR back to draft when review is paused.
• Authenticate with gh auth status and ensure gh is up to date.
• Prefer explicit PR references (number or URL) in scripts to avoid unintended changes.
• Check the PR status after running (e.g., gh pr view) to verify readiness.

Example Use Cases

• Mark the current branch PR as ready when its checks pass.
• Mark PR #456 as ready for review.
• Undo ready on PR #789 when changes are still needed.
• From a feature branch, mark the PR as ready without specifying an ID.
• In CI, automatically mark PRs as ready after successful QA checks.

Frequently Asked Questions