Skill library / Claude Code

Pull Request Description skill for Claude Code

Reviewers approve faster when they understand the change in 30 seconds. This skill writes PR descriptions that explain what changed, why, and how it was tested.

What it's good for

• Opening PRs with gh pr create
• Large feature branches with many commits
• Teams with a PR template

How the skill works

1. Diff the branch against the base branch
2. Write a title in the team's format
3. Summarise the why in 2-3 sentences
4. List notable changes grouped by area
5. Add testing steps and a risk/rollback note

Built-in rules

• Follow .github/pull_request_template.md if present
• Link the issue if the branch name contains an ID
• Don't list every file; group by intent

Example

You: “open a PR for this branch”
Result: A PR with title 'feat: add CSV export to reports', summary, 4 grouped changes and test steps.

SKILL.md template

Save as pull-request-description/SKILL.md.

---
name: pull-request-description
description: "Writes clear pull request titles and descriptions from the branch diff: summary, changes, testing notes and screenshots checklist. Use when the user asks to open a PR, write a PR description, or summarise a branch."
---

# Pull Request Description

## Workflow
1. Diff the branch against the base branch
2. Write a title in the team's format
3. Summarise the why in 2-3 sentences
4. List notable changes grouped by area
5. Add testing steps and a risk/rollback note

## Rules
- Follow .github/pull_request_template.md if present
- Link the issue if the branch name contains an ID
- Don't list every file; group by intent

How to install in Claude Code

Unzip into .claude/skills/ in your project (or ~/.claude/skills/ for all projects) and invoke it with /skill-name.

Pro tip

Combine with the Commit Message skill for a clean end-to-end git workflow.

FAQ

Related skills

• Code Review skill for Claude Code
• Commit Message skill for Claude Code
• API Documentation skill for Claude Code