diff --git a/pr-review-toolkit/README.md b/pr-review-toolkit/README.md index 690a524..49d5d2c 100644 --- a/pr-review-toolkit/README.md +++ b/pr-review-toolkit/README.md @@ -39,6 +39,26 @@ analysis and scoring (Sonnet + Haiku agents) → per-item action confirmation → plan generation → implementation → reply posting. +## Usage + +Review a PR in one command. `claude --worktree` checks out the PR head into an +isolated worktree, and the trailing slash command runs the review immediately: + +```bash +claude --worktree '' --permission-mode auto /pr-review-toolkit:review-pr +``` + +- `--worktree ''` fetches the PR head (`pull/N/head`) into a detached + worktree, leaving your current checkout untouched. +- `--permission-mode auto` starts the session in Auto mode so the review's + read-only and GitHub MCP steps run with fewer prompts (see + [Permissions](#permissions)). Auto mode needs a supported model and may be + disabled by your settings or organization; when unavailable it falls back to + Manual mode. Omit the flag to use your configured default permission mode. + +If you review PRs often, wrap this in a shell function or alias that accepts a +PR URL and passes it to the command above. + ## Review Flow The skill requires only that the current directory is a git checkout of the