PR Description Skill: Summary, Notes, Real Test Plan
A PR description is read once, used to decide if reviewers care, and then ignored. The job is to land that decision in 10 seconds — what changed, why, and what's worth verifying. This skill produces exactly that shape: short summary, optional notes, real test plan.
Full Prompt
An installable PR-description skill. Reads the diff and commit log on the current branch, distills it into a tight summary plus a real test plan you'd actually run.
What It Does
- Reads the diff and commit log —
git log <base>..HEADplus the actual code change - One purpose, one sentence — the lede the reviewer reads first
- Test plan you'd actually run — "load
/dashboardas a free-tier user" beats "test the upgrade flow" - No empty sections — no "Screenshots:" placeholder, no checkbox stubs the repo doesn't use
Install in 30 Seconds
Pick your tool above and hit Download:
- Claude Code:
~/.claude/skills/pr-description/SKILL.md - OpenAI Codex CLI: append to
AGENTS.md - Cursor: append to
.cursorrules
Stage your branch, ask for a PR description, and paste the result into the GitHub body.
Why Tight Beats Comprehensive
The PR description that gets reviews approved is the one a busy maintainer can read on their phone. Long descriptions get skimmed; padded descriptions get ignored entirely. This skill enforces the 200-word ceiling and the test-plan-not-vibes-check structure that actually moves PRs through review.
Install once, ship clean PRs every time.