create-pr
Installation
SKILL.md
Generate Pull Request Description
Generate a short, narrative PR description that tells reviewers why this change exists and what to expect when they open the diff. Reviewers skim. If the description is long, they skip it. Respect their time.
Modes
Parse $ARGUMENTS. --split selects an alternate workflow; --review is an additive flag that composes with the default workflow.
| Mode / Flag | Trigger | Behaviour |
|---|---|---|
default |
No flag | One PR for the whole branch. Follow Steps 1–10 below. |
split |
--split, -s, or first positional token split |
Analyse the branch diff, propose 2–4 dependency-ordered draft PRs (hard cap 5), execute only after user approval. Jump to the Split Mode section after reading Core Principles. |
review |
--review, -r, or phrase with claude review / claude review anywhere in arguments |
After Step 6, post @claude review on the PR, dispatch a background subagent that waits for Claude's review and runs /implement-suggestion, then continue with Steps 7+ in parallel. See Review Mode. |
In split mode, skip Step 5's "PR too big" trim — the split is the response to that signal. Each resulting sub-PR must still pass it on its own.