review-walkthrough captures the full diff of the current branch against its base and builds a single HTML page for reading it. Files are grouped into steps by concept, with definitions before their consumers and tests beside their subjects, and every step carries an explanation and a list of findings with severity.
It runs only when you call it by name. When the branch belongs to a GitHub pull request, the page lets you pick findings and copy a gh api command for inline review comments. The page never posts anything itself.
What You Get
- A standalone HTML file with the branch diff split into ordered, explained steps
- Findings per step with high, medium or low severity, anchored to a file and line on the left or right side of the diff
- A copyable gh api command for selected findings when the branch has a matching GitHub PR
- A note on any uncommitted work left out of the walkthrough
Common Use Cases
- Reading a large pull request in a sensible order before approving it
- Preparing a branch for reviewers with an explanation of each change
- Sorting out review comments and exporting the chosen ones to a PR
What Makes It Unique
The reading order follows comprehension, not commit order, while the renderer checks that no diff is rewritten, dropped or repeated. Findings must anchor to real lines in the displayed diff, and the PR export copies a command for you to run yourself, so nothing is posted to GitHub automatically. The skill is read-only: it does not run the project’s tests or install its dependencies.
Under The Hood
The agent runs git commands (rev-parse, merge-base, diff, and a symbolic-ref lookup) to capture the patch, and may query GitHub PR metadata when it is available. It writes a JSON file and a patch file to temporary locations outside the checkout, then runs the bundled Python renderer through uv. The renderer calls git apply to parse paths, validates the data and writes the HTML file. The agent then opens the file in a browser with open or xdg-open when one exists. The generated page itself only builds a gh api command for you to copy; it does not run it. The skill can be invoked only by name.