PR Descriptions for Maintainers
The Commits
Don’t Explain the Risk
Get a PR description built from the actual diff, commits, and tests, so your reviewer sees the real decisions and risk, not a rehash of the commit log.
PR descriptions restate commit titles. The reviewer still has to read the whole diff to find the risk.
The external problem
Your description says “fix race condition” or “refactor auth,” the same words as the commit title, and never says what actually changed, what the tradeoff was, or where the risk sits.
The internal problem
You know the reviewer is going to read the whole diff anyway, so writing the description starts to feel like a formality you fill in on the way to submit.
What's at stake
A maintainer who can’t find the risk in the description either reads the whole diff cold or merges on trust and finds the edge case in production.
Four steps, from diff to draft.
Run it from an open PR. It reads the repo directly, then drafts against the same checklist a maintainer would use to catch a generated-sounding description.
Read the Diff
Pulls the actual diff, commit history, CI status, and existing review comments straight from the repo, since a commit title claiming a fix is not proof the fix works.
Confirm Manual Testing
Asks you exactly what you tested by hand. Your answer becomes the Verification section word for word, with everything untested moved to a numbered post-merge checklist.
Draft the Structured Body
Writes the numbered What Changed and Why section with bolded end-state lines and labeled Key decision and What changed sub-bullets, plus verification, migrations, and open calls for the reviewer.
Self-Check the Draft
Rereads the draft against an eleven-point checklist before handing it back: no fact stated twice, every Key decision names a real rejected alternative, no raw code or status codes in prose.
Use it now. It's free.
Works on all platforms. Pick yours and get set up in under a minute.
Download & upload in 60 seconds
One click downloads the zip and opens Claude.ai.
Click below — the zip downloads and Claude.ai opens.
Click the + button in the skills column on the left.
Select Create a skill.
Select Upload a skill and upload the zip.
Start your pr description rewrite by running /estack-pr-description.
PR Description ships in E-Stack, a set of 20 free skills installed by one command. See the whole stack.