pr Skill (mattpocock) for Claude Code: Write Clearer PR Descriptions

Makes Claude write a pull request description with a summary diagram, before and after evidence, and a merge-danger note.

Installs: 202.1K; on skills.sh
Stars: 309.2K; on GitHub
Files: 2; besides SKILL.md
Updated: Nov 2026; last repo commit

pr gives Claude a fixed template for a PR body. It has three sections: Summary, Evidence and Merge Danger. The summary is a picture, such as pseudocode, a call tree, a component tree, a file tree, a Mermaid diagram or a diff, picked to be the smallest view that makes the point.

Evidence asks for a before and after, with screenshots first and test output second. Merge Danger says whether the change is a one-way or two-way door and names its blast radius. The skill triggers when you ask for a PR body. It bundles no scripts. The SKILL.md tells Claude to use your domain language from GLOSSARY.md.

Good for

Developers who want PR descriptions reviewers can scan in a minute
Teams that review AI-written pull requests and want proof the change works
Claude Code users who already use the mattpocock skills set

Install pr

Claude Code

Copy this prompt.

Install the pr skill in Claude Code. Run this command:

npx skills add https://github.com/mattpocock/skills --skill pr

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Use when writing a PR body.

Sections in SKILL.md

Summary
Evidence
Merge Danger
Sections
Summary
Evidence
Merge Danger

Key facts

Author: Matt Pocock (repo owner)
Credit: Adapted from the show-me skill by Dex Horthy (Humanlayer)
License: MIT
Installs on skills.sh: 202,079 (Nov 2, 2026)
GitHub stars: 309,237 (Nov 2, 2026)
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Last commit: 2026-11-01
Files: SKILL.md plus 2 bundled files: CREDITS.md and agents/openai.yaml
Template: 3 sections: Summary, Evidence, Merge Danger

What it includes

Shows the change as pseudocode, a tree, a Mermaid diagram or a diff
Claude picks the smallest picture that makes the key point. It can use pseudocode, a call tree, a component tree, a file tree, a Mermaid diagram or a diff.
Read · Summary
Adds a before and after, with screenshots first and test output second
For visual changes the skill asks for screenshots. Otherwise it asks for test results or console output, showing the test that now passes.
Read · Evidence
Labels the change a one-way or two-way door and names its blast radius
A two-way door can be rolled back. A one-way door, such as a destructive or hard-to-reverse change, is higher risk. Blast radius is the one-word scope of what could break.
Read · Merge Danger
No preambles, brief prose, your own domain language from GLOSSARY.md
The skill tells Claude to skip introductions and keep prose short. It uses the terms in your GLOSSARY.md.
Files · Style rules

From the official docs

Questions

What does the pr skill do?

It makes Claude write a PR body in a fixed shape: a Summary drawn as a diagram or tree, Evidence with a before and after, and a Merge Danger note. It triggers when you ask Claude to write a PR body.

How do I install it in Claude Code?

Use the install box above. It adds the skill from the mattpocock/skills repo. In Claude Code the skill then loads when you ask for a PR description, for example "write the PR body for this branch".

Does it need an API key or a script?

No key is mentioned in the SKILL.md, and the skill bundles no scripts. It only holds the template and the writing guidance.

Does it open the pull request for me?

The SKILL.md only covers the text of the PR body. It does not describe creating or pushing the pull request.

Where does this skill come from?

The SKILL.md credits the show-me skill by Dex Horthy of Humanlayer. This copy sits in Matt Pocock's skills repo under the engineering folder.

Is it safe to install?

The skill bundles no scripts and the SKILL.md holds only a PR body template and writing guidance. Two other files ship with it, CREDITS.md and agents/openai.yaml. Read the SKILL.md before you install it, as with any skill.

Information

updated Nov 2, 2026

Repository: mattpocock/skills
Folder: skills/engineering/pr

mattpocock/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

SKILL.md · github.com
skills.sh listing · skills.sh
GitHub repo · github.com