async-pr-review

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Reviewing a pull request manually requires running builds, lint checks, tests, and reading diffs, which blocks your terminal and attention. This Skill offloads the entire review pipeline to background jobs so you can keep working and check the synthesized verdict later. ## Core Features & Use Cases - Background Review Pipeline: Dispatches five parallel tasks (PR diff fetch, build and lint, AI code review, CI-aware test execution, and manual behavior verification) as detached background jobs. - Ephemeral Git Worktrees: Checks out the PR into a temporary worktree under .gemini/tmp/async-reviews to avoid git lock conflicts and workspace pollution. - Status Checking and Final Assessment: A check script reports per-task status, and a final Gemini-generated assessment summarizes build, test, and review results with an approval recommendation. - Use Case: You are asked to review PR #123 but are mid-task. Start the async review, continue working, then later ask for the status and receive a synthesized recommendation on whether to approve. ## Quick Start Start an asynchronous review for pull request 123 and notify me 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 tool's background flag. It fetches the PR into a temporary git worktree and dispatches build, test, and AI review jobs in parallel.

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

Run check-async-review.sh with the PR number. It prints STATUS: IN_PROGRESS with running tasks, STATUS: COMPLETE with the log directory, or STATUS: NOT_FOUND if no review exists for that PR.

Does the async review modify my current working branch?

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

What tools are required for the async PR review scripts?

The scripts require git with worktree support, the GitHub CLI (gh) for PR diffs and CI checks, npm for build and test commands, and the gemini executable for headless AI review and assessment synthesis.

Why does the review skip local npm tests sometimes?

Local tests are skipped when GitHub CI checks pass or are still pending, to avoid duplicate work. If CI fails, the script extracts failing test files from CI logs and runs only those locally.