async-pr-review

Runs background PR reviews with builds, tests, and Gemini-generated assessments in ephemeral git worktrees.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/bkrsna/gemini-cli --skill async-pr-review-bkrsna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: async-pr-review
Source: https://github.com/bkrsna/gemini-cli/tree/main/.gemini/skills/async-pr-review
Command: npx skills add https://github.com/bkrsna/gemini-cli --skill async-pr-review-bkrsna

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Reviewing a pull request manually requires checking out branches, running builds and tests, and reading diffs, which blocks your terminal and interrupts your current work. This Skill offloads the entire review to background jobs so you can keep working and check the results later. ## Core Features & Use Cases - Background Review Jobs: Launches parallel background tasks that fetch the PR diff, run build/lint checks, execute tests, and generate a Gemini-powered code review. - Ephemeral Git Worktrees: Provisions temporary worktrees under .gemini/tmp/async-reviews so reviews never touch your main workspace or cause git lock conflicts. - Status Checking & Final Assessment: A companion script reports per-task status and synthesizes a final recommendation on whether the PR builds, passes tests, and should be approved. - Use Case: You are asked to review PR #123 but are mid-task. Start an async review, continue working, then later ask for the status to receive a synthesized approval recommendation based on build, test, and review logs. ## Quick Start Start an asynchronous review for pull request 123 and let me know when the final assessment is ready.

Frequently Asked Questions about async-pr-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a PR review in the background?

Run the async-review.sh script with the PR number as its argument, launched with the shell background flag. It fetches the PR into a temporary git worktree and dispatches build, test, and review tasks in parallel.

How do I check the status of an async PR review?

Run check-async-review.sh with the PR number. It prints per-task status lines and outputs STATUS: IN_PROGRESS or STATUS: COMPLETE along with the log directory path for reading the final assessment.

Does async PR review modify my current git working directory?

No. The script creates an ephemeral git worktree under .gemini/tmp/async-reviews/pr-<number> and fetches the PR branch there, so your main workspace and checked-out branch remain untouched.

What tools are required for async PR review to work?

The scripts require git, the GitHub CLI (gh) for PR diffs and CI checks, npm for build and test commands, and a Gemini CLI binary for headless AI review and test execution tasks.

What happens if the build fails during an async review?

The npm test and test execution tasks wait for the build-and-lint step and are skipped with a failure exit code if it fails. The status script then reports those tasks as failed with the last log lines.