| name | pr-description |
| description | Generate PR description from template and git changes. Use when creating a PR and want to auto-generate description based on .github template, commits, and diffs. Extracts Jira tickets from commit messages. |
PR Description Generator
Reads .github/pull_request_template.md (or uses sensible defaults), analyzes your branch changes vs main, and generates a PR description with:
- Extracted Jira ticket (PROJ-123 format)
- Concise change summary from commits
- Test instructions placeholder
- PR checklist
- Any other sections from the template
Output goes directly to clipboard.
Quick start
/pr-description
Analyzes current branch vs main, generates description, copies to clipboard.
To specify different base branch:
/pr-description --base develop
How it works
- Reads template — Looks for
.github/pull_request_template.md in repo root
- Parses commits — Extracts from
git log <base>...HEAD
- Jira ticket (first match of
PROJ-123 or [PROJ-123])
- Commit messages for description
- Analyzes diff —
git diff <base>...HEAD to understand scope
- Generates content:
- Ticket: From commits (if found)
- Summary: Concise description of changes (not verbose)
- Testing: Template placeholder for user to fill
- Checklist: Standard PR items
- Copies to clipboard — Ready to paste into PR
Default template (if none in repo)
## Description
{summary}
## How to test
{placeholder}
## Ticket
{jira_ticket}
## Checklist
- [ ] Tests pass
- [ ] No breaking changes
- [ ] Docs updated (if needed)
Notes
- If
.github/pull_request_template.md exists, it's used instead of default
- Jira ticket extracted from commit messages (first match)
- Change summary is generated from commit titles, not verbose
- Modify output in PR UI before submitting — this is a starting point
