PD
PR Description
🔵 Stable🕐 updated 2026-06-30
🔷 SkillSpec L3
pm-craft
Write a clear pull-request description that gets reviewed fast and merged with confidence. Use when opening a PR, summarizing a change for review, or asked to write a PR/merge-request description. Produces a structured PR: what changed and why, how it was tested, risk and rollout, and a focused reviewer guide — so the reviewer understands intent before reading a single diff line.
What to give it
▸The change — what was done (the diff summary, commits, or a description).
▸The why — the problem/issue it solves (link the ticket).
▸Testing — how it was verified (tests added, manual steps, edge cases checked).
▸Risk & rollout — blast radius, migrations, flags, backward compatibility, how to roll back.
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓Title is concise and imperative; the why and linked issue are clear up front
✓Changes summarize intent, not a file-by-file dump
✓Testing is specific (what was run, which edge cases) — not "tested locally"
✓Risk, rollout, and rollback are addressed (even if "low risk, none")
✓A reviewer guide points to where to focus and flags anything uncertain
✓Length is proportional to the size of the change
⚠️ What it refuses to do
Do not just paste the commit list — explain intent the diff can't convey
Do not say "tested" without saying how — give the reviewer something to trust
Do not hide risk or migrations — surface them so they're reviewed deliberately
Do not write a novel for a one-line change — match effort to size
Do not omit the "what to focus on" — undirected review is slow review
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcpRelated skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="pr-description"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>💬 Discussion
PR Description is one of 625 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog