From 97cceb07c0e817527d16cb27c17c069c66a7d7fe Mon Sep 17 00:00:00 2001 From: Christoph Blecker Date: Tue, 18 Aug 2026 16:57:22 -0700 Subject: [PATCH] docs(pr-review-toolkit): add usage example Document the one-command review invocation (claude --worktree + --permission-mode auto + the review-pr slash command) in a new Usage section, including Auto mode prerequisites and its Manual fallback. Assisted-by: Claude:claude-opus-4-8 --- pr-review-toolkit/README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) 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