Branch Review

Audit unmerged branches and generate a CHANGES.md at the repository root.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AlastairThomson/AgentSkills --skill branch-review-alastairthomson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Branch Review
Source: https://github.com/AlastairThomson/AgentSkills/tree/main/skills/global-scope/branch-review
Command: npx skills add https://github.com/AlastairThomson/AgentSkills --skill branch-review-alastairthomson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review unmerged branches, classify each, produce CHANGES.md, and recommend merge/prune/PR actions. Use when the user asks to audit the branch state or produce a CHANGES.md. Delegates the investigation to the branch-review agent so per-branch evidence does not bloat the main conversation's context.

Core Features & Use Cases

  • Thin stub that triggers on "review branches" / "produce CHANGES.md" requests and delegates to the branch-review agent.
  • Writes CHANGES.md at the repository root with per-branch evidence and recommended actions.
  • Keeps the main conversation lean by moving heavy analysis to the agent.

Quick Start

Invoke the Agent tool with subagent_type: "branch-review" to perform the review and return its recommendations.

Frequently Asked Questions about Branch Review

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

FAQPage Schema
How do I audit unmerged git branches and generate a summary file?

To audit unmerged git branches and generate a summary, this Skill delegates per-branch analysis to a branch-review agent and writes a CHANGES.md file at the repository root with evidence and recommended actions.

What is the best way to review branch state without bloating the main conversation context?

Reviewing branch state without bloating the main context is achieved by delegating heavy per-branch investigation to a subagent, which returns only the final recommendations to the main conversation.

How do I automatically generate a CHANGES.md file at the repository root?

You can automatically generate a CHANGES.md file at the repository root by triggering the branch review process, which classifies unmerged branches and writes their state evidence directly to the file.

Can I automate merge and prune recommendations for unmerged branches?

Yes, you can automate merge and prune recommendations for unmerged branches by running the branch audit, which classifies each branch and outputs suggested actions in the generated CHANGES.md.

Does the branch review process require any external dependencies or components?

The branch review process requires no external dependencies or components, operating as a thin stub that invokes the built-in Agent tool with the branch-review subagent type.

When should I not use an automated branch audit agent?

You should not use an automated branch audit agent if your repository lacks unmerged branches or if you need to manually curate the CHANGES.md file instead of relying on automated per-branch evidence collection.