stage-chapters

Generate narrative Stage chapters from git branch diffs for browser review.

259|24|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/ReviewStage/stage-cli --skill stage-chapters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stage-chapters
Source: https://github.com/ReviewStage/stage-cli/tree/main/skills/stage-chapters
Command: npx skills add https://github.com/ReviewStage/stage-cli --skill stage-chapters

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates generating narrative Stage chapters from the current git branch and opens them in a browser for review.

Core Features & Use Cases

  • Auto-detects the base branch and computes a diff via stagereview prep.
  • Clusters changes into coherent story beats and generates a prologue.
  • Launches the SPA with stagereview show to provide an in-browser review experience.

Quick Start

Run /stage-chapters to generate Stage chapters for the current git branch and open them in your browser.

Frequently Asked Questions about stage-chapters

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

FAQPage Schema
How do I generate narrative chapters from my git branch diff for code review?

To generate narrative chapters from a git branch diff, run the stage-chapters command to auto-detect the base branch, cluster your code changes into story beats, and launch an in-browser review experience.

How does stagereview prep and show workflow snapshot diffs into structured chapters?

The stagereview prep and show workflow snapshots your local development diffs against the main branch, clusters them into coherent structured chapters with a prologue, and launches a single-page application to display them in your browser.

Do I need the stagereview tool and a local git repo to generate Stage chapters?

Yes, generating Stage chapters requires the stagereview tool installed and a local git repository, because the workflow computes diffs against your base branch to construct the narrative review output.

Can I automate clustering code changes into story beats for focused reviews?

You can automate clustering code changes into story beats by running the stage-chapters command, which processes your branch diffs and groups them into structured narrative chapters ready for focused browser review.

What is the best way to review local development diffs in a browser?

The best way to review local development diffs in a browser is using stagereview show, which launches a single-page application displaying your branch changes clustered into narrative chapters and a prologue.

Why does my generated git branch review group unrelated commits together?

Your generated git branch review groups commits together by clustering code diffs into coherent story beats, an automated narrative approach designed to provide focused context rather than strictly chronological commit lists.