skills.rest
nrwl
nrwlOFFICIAL
Explore all skills by this author →
Website𝕏@nxdevtoolsGitHub

review-local-branch

Reviews local git branch changes against a merge-base using sandboxed review agents.

29.3k|3.0k|Updated Aug 11, 2017
Search Tags:#Git#diff#pre-pr#Code review#Sandbox#Multi-Agent#local branch
One-click install
npx skills add https://github.com/nrwl/nx --skill review-local-branch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-local-branch
Source: https://github.com/nrwl/nx/tree/main/.claude/skills/review-local-branch
Command: npx skills add https://github.com/nrwl/nx --skill review-local-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It provides a deep, multi-agent code review of work on your current local branch before it becomes a pull request, covering committed, staged, and unstaged changes in one pass.

Core Features & Use Cases

  • Full-scope diffing: Computes the diff from merge-base to working tree so commits, staged, and unstaged edits are reviewed together, with untracked files explicitly flagged as not reviewed.
  • Multi-agent review lanes: Dispatches implementation, verification, approach, and security reviewers at configurable levels (quick, standard, deep) through a sandboxed CLI.
  • Draft persistence: Saves a structured review draft with frontmatter metadata to ~/.nx-branch-reviews/<branch>.md, outside the repo so it survives rebases and git clean.
  • Use Case: Before pushing a feature branch, run the review to catch critical and important issues, pre-existing defects, and design concerns while a rework only costs you a rebase.

Quick Start

Ask the assistant to review this branch before opening a PR, optionally specifying a base revision or review level such as standard or deep.

Frequently Asked Questions about review-local-branch

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

FAQPage Schema
How do I review my local branch before creating a pull request?▼

Run the review on your current branch; it diffs the merge-base with origin/master against your working tree so commits, staged, and unstaged changes are reviewed together. A draft report is saved to ~/.nx-branch-reviews/<branch>.md.

What review levels does the local branch review support?▼

Three cumulative levels: quick runs only the implementation reviewer, standard adds verification, approach, and security reviewers, and deep adds comment, docs, performance, and security specialists. You can also select agents explicitly with --agents.

Does the local branch review modify my working tree or commits?▼

No. It never commits, pushes, or edits your working tree. The sandbox runs in screened mode that rejects write commands, and agent checks that must mutate code run in a separate git worktree outside the repo.

Why are untracked files not included in the branch review?▼

Untracked files cannot appear in a git diff at any syntax, so no agent sees them. They are collected separately and listed under a Not reviewed section in the draft so the gap is explicit.

Can I review a branch stacked on another branch instead of master?▼

Yes. Pass --base <rev> to override the merge-base, otherwise the diff against origin/master would pull the parent branch's work into scope and waste the review on code you did not write.

Related Skills

Explore More Software Engineering Skills→
paulundpaulund

commit-push-pr

Automate Git commits, pushes, and pull request creation from a new branch.

Community
Intermediate
jitraponjitrapon
11

review-pr

Fetch and summarize GitHub pull request review comments by status.

Community
Intermediate
testdoubletestdouble
198

refactor

Refactor code iteratively with test-gated validation after each step.

Official
Advanced
mlflowmlflow
1

add-review-comment

Post review comments to GitHub pull requests via the GitHub CLI.

Official
Intermediate