pr-walkthrough

Generates an author-perspective briefing that walks reviewers through a pull request diff.

1|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/taxmaxi/taxmaxi --skill pr-walkthrough-taxmaxi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-walkthrough
Source: https://github.com/taxmaxi/taxmaxi/tree/main/.agents/skills/pr-walkthrough
Command: npx skills add https://github.com/taxmaxi/taxmaxi --skill pr-walkthrough-taxmaxi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewers often open a pull request cold, without context on why changes were made or which parts deserve scrutiny. This Skill prepares a first-person author briefing that explains the intent behind a PR, ranks the risky hotspots, and surfaces the author's own doubts so reviews are faster and sharper. ## Core Features & Use Cases - Diff Resolution: Identifies the PR from a number, URL, the current branch against its merge-base, or uncommitted changes using GitHub CLI commands. - Structured Briefing: Produces a walkthrough with a story section, ranked hotspots with file:line pointers, and honest author confessions grounded in the diff. - Plain-Language Writing: Applies communication rules so a reviewer unfamiliar with the subsystem can follow every sentence without a glossary. - Use Case: A teammate asks to be prepped before reviewing a branch that changes billing logic; the Skill reads the full diff, linked issue, and commit messages, then delivers a briefing highlighting the two risky files and an untested edge case. ## Quick Start Walk me through the changes on this branch as if you wrote them, so I can review the PR.

Frequently Asked Questions about pr-walkthrough

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

FAQPage Schema
How do I get a walkthrough of a pull request before reviewing it?▼

Provide a PR number or URL, or check out the branch, and ask for a walkthrough. The Skill reads the full diff, linked issue, and commit messages, then delivers a briefing with the story, ranked hotspots, and the author's confessions.

How does the PR walkthrough decide which diff to explain?▼

It resolves the diff in a fixed order: a PR number or URL you provide via gh pr view or gh pr diff, otherwise the current branch against its merge-base with the main branch, otherwise uncommitted changes. It states which one it picked.

Can I use this for uncommitted local changes instead of a PR?▼

Yes. If no PR or branch diff is available, the Skill falls back to uncommitted changes in the working tree and briefs you on those. It always states which diff source it selected.

Does the walkthrough modify the code being reviewed?▼

No. The deliverable is only the briefing; the code is left untouched. The reviewer decides what to act on after reading the hotspots and confessions.

What makes the briefing readable for someone new to the subsystem?▼

It describes each thing by what it does before naming it, unfolds compressed jargon into cause and effect, and carries one concrete example through the whole briefing. A cold-read pass rewrites any sentence that relies on unexplained terms.