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.
Install
/plugin marketplace add borghei/Claude-SkillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add borghei/Claude-Skills --skill pr-description-writergit 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-writerPersonal 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
Details
- Skill name
pr-description-writer- Repository
- borghei/Claude-Skills
- Path
engineering/pr-description-writer/SKILL.md- Repo updated
- 8 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
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.2kborghei/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.
Customer Success Manager
1.2kborghei/Claude-Skills
Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success
Financial Analyst
1.2kborghei/Claude-Skills
Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making
PR Review Expert
1.2kborghei/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 Worktree Manager
1.2kborghei/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.
Release Orchestrator
1.2kborghei/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).
Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.