✍️Skill only
PR description writer
Generates a Summary + Test Plan + Rollout PR body from the branch's commits and diff.
- Surfaces
- skill
- Complexity
- beginner
- Trigger
- natural
- Est. tokens
- 2,800
What It Does
Runs git log and git diff on the current branch versus main, then drafts a three-section PR body: Summary, Test Plan, Rollout. Output is ready to paste into GitHub, GitLab, or any PR system.
When It Triggers
- ▸"Write the PR description"
- ▸"Draft a PR body for this branch"
- ▸"Generate PR text for review"
SKILL.md
markdown
---
name: pr-description-writer
description: Generates a PR description from the current branch's commits and diff. Produces Summary + Test Plan + Rollout sections. Use when user says "write PR description", "draft PR", or "generate PR body".
---
# PR Description Writer
## Steps
1. Run `git log main..HEAD --oneline` to list commits on the branch
2. Run `git diff main...HEAD --stat` to understand scope
3. Draft description with three sections:
- **Summary**: 1-3 bullets of what changed and why
- **Test Plan**: concrete verification steps
- **Rollout**: deployment notes, feature flags, migrations
4. Output as Markdown, ready to paste
## Rules
- Focus on the "why", not the "what"
- Never invent features not in the diff
- Keep under 200 words
Variants
- ▸Pair with agent-orchestrates-skills to auto-open the PR with the generated body.
- ▸Hook into a PostToolUse after "git push" to pre-generate descriptions as soon as you push a branch.
Gotchas
- ▸Branches with 20+ commits produce noisy summaries — squash first.
- ▸If `main` is not your base branch, edit the skill to use the right base.
- ▸Do not let it invent features — the prompt explicitly forbids it, but monitor the first few outputs.