stage-chapters

Generate reviewer-friendly chapter summaries for local git branch diffs.

Updated May 28, 2026
One-click install
npx skills add https://github.com/haryelramalho/skills --skill stage-chapters-haryelramalho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stage-chapters
Source: https://github.com/haryelramalho/skills/tree/main/skills/community/stage-chapters
Command: npx skills add https://github.com/haryelramalho/skills --skill stage-chapters-haryelramalho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a local git branch into a readable review package so someone can understand the change without digging through raw diffs or opening each file by hand.

Core Features & Use Cases

  • Diff to narrative: Breaks a branch diff into reviewer-friendly chapters that explain what changed and why it matters.
  • Browser-based review: Launches Stage Review in a browser so you can inspect the change set visually.
  • Human judgment flags: Surfaces lines that may need a product or workflow decision from a reviewer.
  • Use case: Run it before sharing a branch to give teammates a clear, structured review flow instead of a wall of hunks.

Quick Start

Use the stage-chapters skill to generate review chapters for my current local git branch and open them in a browser.

Frequently Asked Questions about stage-chapters

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

FAQPage Schema
How do I turn git diffs into readable review chapters for my teammates?

To turn git diffs into review chapters, this Skill breaks your local branch diff into reviewer-friendly summaries that explain what changed and why it matters. It organizes the change set so reviewers can understand the context without reading raw hunks.

What is the best way to prepare a local git branch for browser-based code review?

The best way to prepare a local git branch for browser-based review is to generate chapter summaries that launch Stage Review in a browser. This allows reviewers to visually inspect the change set instead of opening each file by hand.

How do I surface lines in a git diff that need a product or workflow decision?

To surface lines needing a product or workflow decision, this Skill generates human judgment flags during chapter creation. These flags highlight specific lines within the diff that may require explicit input from a reviewer.

Does generating git diff chapters require any specific prep commands?

Generating git diff chapters requires running stagereview prep and stagereview show first. These prerequisite commands compute hunks, preserve line references, and validate full diff coverage before the chapters are created.

Can I use this to review work-in-progress branches before sharing them?

You can use this Skill to review work-in-progress branches before sharing them. It is designed for local repositories where change sets need to be explained, organized, and opened for browser-based review prior to team distribution.