skills.rest
kohdice
kohdiceCOMMUNITY
Explore all skills by this author →
Website𝕏@kohdiceGitHub

mini-pr-review

Reviews a GitHub pull request in an isolated worktree and submits one review.

Updated Jul 4, 2023
Search Tags:#code review#pull request#github#git worktree#gh cli#review automation
One-click install
npx skills add https://github.com/kohdice/dotfiles --skill mini-pr-review-kohdice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mini-pr-review
Source: https://github.com/kohdice/dotfiles/tree/main/config/agents/skills/mini-pr-review
Command: npx skills add https://github.com/kohdice/dotfiles --skill mini-pr-review-kohdice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Reviewing pull requests often pollutes your working branch, spawns unnecessary sub-agents, or produces scattered feedback. This Skill performs a single-pass PR review in a temporary git worktree and submits exactly one GitHub review, keeping your local state clean. ## Core Features & Use Cases - Isolated Worktree Review: Checks out the PR into a temporary worktree via a bundled helper script, never touching your current branch. - Single Verdict Submission: Submits exactly one review—approve when no blocking issues exist, request changes with concrete file-level evidence when they do. - Guaranteed Cleanup: Always removes the review worktree before finishing, including on errors, with marker-file safety checks. - Use Case: You are asked to review a teammate's PR while mid-feature on your own branch. Invoke the skill with the PR number; it fetches metadata, reviews the diff in isolation, posts one English review, and cleans up. ## Quick Start Use $mini-pr-review to review pull request number 42 in this repository.

Frequently Asked Questions about mini-pr-review

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

FAQPage Schema
How do I review a GitHub PR without switching branches?▼

Invoke the skill with a PR URL or number; it creates a detached temporary git worktree, checks out the PR there with gh pr checkout, and reviews the diff without touching your current branch. The worktree is removed afterward.

How to submit an approve or request-changes review with GitHub CLI?▼

The skill writes the review body to a temporary file and runs gh pr review with --approve or --request-changes and --body-file. If the authenticated user is the PR author, it falls back to a non-blocking --comment review.

Does this PR review skill run tests or linters?▼

No. It explicitly forbids running tests, formatters, linters, typecheckers, or builds unless the user overrides it. Formatting and test verification are treated as CI's responsibility; the review focuses on correctness, security, and API compatibility.

Can I use this skill with Codex and Claude Code?▼

Yes. The workflow is runtime-neutral and triggers on explicit invocation such as $mini-pr-review in Codex or /mini-pr-review in Claude Code. Implicit invocation is disabled by policy.

What happens if worktree cleanup fails after a review?▼

The cleanup script refuses to remove directories lacking the .mini-pr-review-worktree marker or with an invalid repository root. If cleanup still fails, the skill reports the worktree path and error clearly instead of silently leaving artifacts.

When should I not use mini-pr-review?▼

Do not use it for ordinary PR review requests, which belong to the pr-review skill, or when you need multi-agent analysis, test execution, or reviews of closed PRs. It only runs on explicit invocation and stops if the PR state is not OPEN.

Related Skills

Explore More Software Engineering Skills→
livewirelivewire
23.6k

review-pr

Automate GitHub PR reviews with gh and Bash workflows.

Official
Intermediate
Puzzle9900Puzzle9900

generic-pr-merge

Automate the GitHub Pull Request lifecycle from local changes to main branch merge.

Community
Advanced
RebelliousSmileRebelliousSmile
1

behave

Manage behavioral test suites for Claude skills with dry-run judging.

Community
Advanced
butterflyskiesbutterflyskies
1

elbow-grease

Automates code reviews using multiple sub-agents for systematic analysis.

Official
Advanced