PR Description Writer

Write PR descriptions with evidence, verification steps and a one-way/two-way merge-risk call. Use when opening a PR, when asked to write or fix a PR body, or when checking a description before requesting review.

1,157 stars 217 forksGit & Code Review Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add borghei/Claude-Skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add borghei/Claude-Skills --skill pr-description-writer
Manual install
git clone --depth 1 https://github.com/borghei/Claude-Skills.git /tmp/Claude-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Claude-Skills/engineering/pr-description-writer ~/.claude/skills/pr-description-writer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# PR Description Writer

A PR description exists so the reviewer can decide how hard to look, where to
look, and whether the merge can be undone. Most descriptions fail all three:
they narrate the commits, assert "tested, works", and call the change "low
risk" while it ships a `DROP COLUMN`. This skill writes the body in five
sections (summary, why, evidence, how to verify, merge risk), classifies the
change from its real file list and diff, and lints the result so an honest
classification is enforced rather than hoped for.

This skill is for the **author**. Reviewing someone else's PR (blast-radius
analysis, security scanning, coverage deltas) is a separate job covered by the
`engineering/pr-review-expert` package; this one only produces and checks the
description.

## When to use this skill

- **Opening a PR**: the branch is ready and needs a body
- **Rewriting a weak body**: "fix this PR description", "make this reviewable"
- **Before requesting review**: a mechanical check that evidence, steps and
  rollback are there
- **PRs with migrations, API or contract changes, deletions**: where getting
  the merge-risk call wrong costs an incident
- **CI gate**: fail PRs whose body claims "reversible" while touching
  migrations

## Clarify First

The merge-risk call and the evidence decide whether the description is useful,
and both depend on facts the author has but the diff may not show. Settle the
inputs below before writing. When one is missing or vague and would change the
Read the full skill on GitHub

Details

Skill name
pr-description-writer
Path
engineering/pr-description-writer/SKILL.md
Repo updated
8 November 2026

FAQ

What does the PR Description Writer skill do?

Write PR descriptions with evidence, verification steps and a one-way/two-way merge-risk call. Use when opening a PR, when asked to write or fix a PR body, or when checking a description before requesting review.

How do I install the PR Description Writer skill?

Claude Code plugin: /plugin marketplace add borghei/Claude-Skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is PR Description Writer popular?

It lives in borghei/Claude-Skills, which has 1,157 GitHub stars and 217 forks, and is included in 1 curated skill list.

Related skills

Cto Advisor

1.2k

borghei/Claude-Skills

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Use when assessing technical debt, scaling engineering teams, evaluating technologies, or making architecture decisions.

Software DevelopmentIn 1 list217

Customer Success Manager

1.2k

borghei/Claude-Skills

Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success

Marketing, Sales & BusinessIn 1 list217

Financial Analyst

1.2k

borghei/Claude-Skills

Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making

Finance & CryptoIn 1 list217

PR Review Expert

1.2k

borghei/Claude-Skills

Reviews risky PRs by blast radius: what imports the changed files, breaking API and schema changes, sensitive paths and test deltas. Use when a PR touches shared libraries, APIs, schemas or auth (for general review use code-reviewer).

Git & Code ReviewIn 1 list217

Git Worktree Manager

1.2k

borghei/Claude-Skills

Run parallel Git worktrees without collisions: a port block per worktree, .env sync, health checks for stale or dirty trees, and safe cleanup of merged ones. Use when several branches or agents need running dev servers at once.

Git & Code ReviewIn 1 list217

Release Orchestrator

1.2k

borghei/Claude-Skills

Gates a release from a live git checkout: preflight checks, secret scan, tag-based SemVer bump, changelog and GO/NO-GO score. Use when cutting a release from a repo (offline notes and plans from text: release-manager).

Git & Code ReviewIn 1 list217

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.