Generates pull request descriptions from code diffs.
When to Use
When the user asks to "write a PR description", "create a PR", or "describe these changes"
Before opening a pull request
Process
Determine the diff: git diff main...HEAD (or the appropriate base branch)
Analyze the changes for:
What was added, modified, or removed
The motivation/context behind the changes
Any breaking changes or migration steps
Generate a PR description with this structure:
## Summary
One-paragraph overview of what this PR does and why.
## Changes
- Bullet list of specific changes made
- Group by area/concern if multiple
## Testing
- How to test these changes
- Any manual verification steps
## Notes
- Breaking changes, migration steps, or follow-up work (if any)
Rules
Be concise but complete — a reviewer should understand the PR without reading every diff line
Call out anything risky, non-obvious, or that requires special attention
If the PR is too large (>500 lines), suggest splitting it
Use the project's existing PR template if one exists in .github/PULL_REQUEST_TEMPLATE.md
1---2name: pr-description-writer3description: PR Description Writer4---5# PR Description Writer67Generates pull request descriptions from code diffs.89## When to Use1011- When the user asks to "write a PR description", "create a PR", or "describe these changes"12- Before opening a pull request1314## Process15161. Determine the diff: `git diff main...HEAD` (or the appropriate base branch)172. Analyze the changes for:18 - What was added, modified, or removed19 - The motivation/context behind the changes20 - Any breaking changes or migration steps21223. Generate a PR description with this structure:2324```markdown25## Summary26One-paragraph overview of what this PR does and why.2728## Changes29- Bullet list of specific changes made30- Group by area/concern if multiple3132## Testing33- How to test these changes34- Any manual verification steps3536## Notes37- Breaking changes, migration steps, or follow-up work (if any)38```3940### Rules41- Be concise but complete — a reviewer should understand the PR without reading every diff line42- Call out anything risky, non-obvious, or that requires special attention43- If the PR is too large (>500 lines), suggest splitting it44- Use the project's existing PR template if one exists in `.github/PULL_REQUEST_TEMPLATE.md`
Run npx skillmds@latest add comcclelland/pr-description-writer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
PR Description Writer It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
comcclelland (@comcclelland) published this skill. Their other Agent Skills are listed on their SkillMD profile.