branch-review

Analyze a branch or pull request to produce a structured review.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/justsml/ai-team-skills --skill branch-review-justsml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-review
Source: https://github.com/justsml/ai-team-skills/tree/main/branch-review
Command: npx skills add https://github.com/justsml/ai-team-skills --skill branch-review-justsml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Combined pre-PR shape check and merge-ready review for a branch or PR. Use when the user asks for a code review, PR review, sanity check, 10x engineer perspective, how to split a PR, or whether changes are ready to merge.

Core Features & Use Cases

  • Parallel specialist review to surface issues across correctness, maintainability, and performance.
  • PR splitting guidance, merge readiness assessment, and a consolidated final report.
  • Use Case: When preparing a feature branch for merge, run this skill to generate a structured, multi-perspective assessment and recommended next steps.

Quick Start

Run branch-review on the current branch to generate a structured, actionable report.

Frequently Asked Questions about branch-review

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

FAQPage Schema
How do I get a structured pull request review before merging?

A structured pull request review analyzes your branch to produce actionable assessments across correctness, maintainability, and performance. It runs parallel specialist checks to surface issues and generate a consolidated final report.

What is the best way to split a large pull request for easier code review?

The best way to split a large pull request involves analyzing the branch structure to generate targeted PR splitting guidance. This process evaluates logical boundaries within changes to recommend manageable, review-ready chunks.

Can I run a code review on a local git branch without GitHub authentication?

You can run a code review on a local git branch without GitHub authentication. The process requires git and gh for integration but includes fallback behavior when authentication is unavailable.

Does merge readiness assessment work with standard git and gh commands?

Merge readiness assessment works with standard git and gh commands. It requires git and gh for GitHub integration, with optional jq for JSON parsing to evaluate whether changes are ready to merge.

How does a sanity check evaluate a feature branch before a PR?

A sanity check evaluates a feature branch by performing a combined pre-PR shape check and merge-ready review. It applies multi-perspective assessments to identify potential issues before opening a pull request.

What are the limitations of automated branch review without jq installed?

Without jq installed, automated branch review limitations include reduced JSON parsing capabilities. The process falls back to basic behavior when parsing GitHub API responses, potentially affecting the depth of structured report generation.