Super Good PR Descriptions

A PR description is read by a human who has to rebuild your mental model from zero and decide whether to trust it. The job is to hand them that model fast, prove the parts they'd doubt, and say plainly what you didn't do.

Core insight: lead with why, prove with evidence, state the real blast radius. A changelog tells the reviewer what moved. A super-good PR tells them what to believe, where to look, and what could still bite. The difference is entirely in altitude and receipts, not length.

How to read this skill: the spine below is a map, not a script. Real PRs drop sections that don't apply and add domain-specific ones that do. A one-file fix doesn't need a rollout-sequencing section; a migration does. Match the shape to the change. The non-negotiables are the part that's actually load-bearing, and the section order is just a reliable way to deliver them.

The non-negotiables

These are what make a description land. If a section doesn't serve one of these, cut it.