One verb per invocation.
Verbs
open is the only verb: commit, push, and open a draft PR with a written body.
Procedure: references/open.md.
No verb given, and the branch has commits the base does not: assume open. A
PR already exists for the branch: stop, give its URL, and say open never
updates an existing PR. Do not infer a verb absent from this file.
The two tests
Every body this skill writes passes both. They are the whole quality bar; there is no word count and no mandatory section.
- A reviewer scans it in under 60 seconds. Not reads — scans.
- The body is never more complex than the fix. A one-line dependency bump cannot earn three paragraphs.
Test 2 is decided from the diff before drafting, and test 1 is re-checked against the draft. Both procedures are in references/writing-the-body.md.
Writing the body
Load references/writing-the-body.md before writing any body. There is no template: sections are not mandatory, not fixed in order, and not named in advance. A change that needs one sentence gets one sentence.
Credits
Framing adapted from Dex Horthy's visual-pr; views come from this repo's
show-me. See CREDITS.md.