create-pull-request

name	create-pull-request
description	Create a GitHub pull request the user's preferred way. Use whenever opening, creating, or raising a PR with gh.

Create Pull Request

Use the code:cli, git-workflow, and git-commit skills when available. Only create a PR when the user has explicitly asked for one.

Confirm the branch is on top of upstream main

Fetch first, then test whether the branch already contains the tip of origin/main:

git fetch origin
git merge-base --is-ancestor origin/main HEAD

• Non-zero means the branch is behind. Offer to rebase onto origin/main before creating the PR rather than opening a stale PR.

Set the title from the actual commit message

Never type the title from memory. Read it from git in a subshell so it matches exactly.

First count the commits the branch adds over origin/main:

git rev-list --count origin/main..HEAD

• if one commit, then the title is that commit's message.

  git log -1 --pretty=%s
  

• More than one: write a short one-sentence summary title — same style as a commit message (present-tense verb, one line, no trailing paragraphs).

Keep the body empty

Always pass an explicit empty string for the body so gh does not prompt or auto-fill.

--body ""

Create the PR

When a browser is available, open the prefilled page for final review:

gh pr create --web --title "$(git log -1 --pretty=%s)" --body ""

On a headless system without a browser, drop --web:

gh pr create --title "$(git log -1 --pretty=%s)" --body ""