Auto-Generate Pull Request Descriptions from Your Git Diff

A good PR description saves your reviewer time and makes your changes easier to merge. Most developers write terrible ones because they're written last and in a hurry. Let Claude write them instead.

git diff main...HEAD | claude -p "Write a GitHub pull request description for
these changes. Include a summary of what changed and why, a list of key changes,
and any testing notes. Format it as Markdown."

Claude reads the actual diff and writes a description that explains the changes in human terms — not just a list of commit messages.

Add a shell alias to make this a one-liner:

# Add to ~/.zshrc or ~/.bashrc
alias prdesc='git diff main...HEAD | claude -p "Write a GitHub PR description
with summary, key changes, and testing notes. Use Markdown."'

Then just run prdesc when you're ready to open your PR.

You can tailor the output to match your team's PR template:

git diff main...HEAD | claude -p "Write a PR description using this template:
## What changed
## Why
## How to test
## Screenshots (if applicable)"

For context-heavy PRs, include your JIRA ticket or issue number in the prompt and Claude will reference it in the description.

Good PR descriptions are a gift to your reviewers and your future self.