pr-description-writer SKILL.md skillA

pr-description-writer from borghei/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add borghei/claude-skills/pr-description-writer@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
borghei/claude-skills
Path
engineering/pr-description-writer/SKILL.md
Versions recorded
2
Latest version
v1.0.0, committed Nov 8, 2026
First version recorded
Nov 8, 2026
Size
12,977 bytes
Repository stars
1,075
License
a license file GitHub does not identify

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add borghei/claude-skills/pr-description-writer@sha256:d4ff17bcf5598ecb

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3trzds7f5bwt334e.svg)](https://markdownregistry.com/a/art_3trzds7f5bwt334e)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Nov 8, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-11-08 6ac3bdb 12,977 BA view · diff
v1.0.02026-11-08 3870dcc 12,962 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12977 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

borghei/claude-skills · 1,075 stars · license a license file GitHub does not identify · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3trzds7f5bwt334e
GET https://markdownregistry.com/api/v1/resolve?ref=borghei/claude-skills/pr-description-writer
GET https://markdownregistry.com/api/v1/blob/d4ff17bcf5598ecb6e92253284b672c1cde221829b01cf2fd3ef3457b9f43049

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from borghei/claude-skills

python-tools Cursor rule
borghei/claude-skills · .cursor/rules/python-tools.mdc · Conventions for the Python automation tools that ship inside skills.
git:20260629.ee6fb37 · audit A · 1,075 stars
repo-overview Cursor rule
borghei/claude-skills · .cursor/rules/repo-overview.mdc · What the AI Skills Library is, its structure, and core principles. Apply when reasoning about the repo as a whole.
git:20261023.4fa0452 · audit A · 1,075 stars
skill-authoring Cursor rule
borghei/claude-skills · .cursor/rules/skill-authoring.mdc · Conventions for writing or editing a SKILL.md skill package.
git:20260629.ee6fb37 · audit A · 1,075 stars
.cursorrules Cursor rule
borghei/claude-skills · .cursorrules
git:20261023.4fa0452 · audit A · 1,075 stars
AGENTS.md AGENTS.md file
borghei/claude-skills · AGENTS.md
git:20261007.6533a59 · audit A · 1,075 stars
CLAUDE.md CLAUDE.md file
borghei/claude-skills · CLAUDE.md
git:20261007.4a698e8 · audit A · 1,075 stars
CLAUDE.md@agents CLAUDE.md file
borghei/claude-skills · agents/CLAUDE.md
git:20260321.deb73d4 · audit A · 1,075 stars
CLAUDE.md@business-growth CLAUDE.md file
borghei/claude-skills · business-growth/CLAUDE.md
git:20260527.3201c50 · audit A · 1,075 stars
channel-economics SKILL.md skill
borghei/claude-skills · business-growth/channel-economics/SKILL.md · Channel economics: design and analyze the financial structure of go-to-market channels. Use when picking a channel mix…
v1.0.0 · audit A · 1,075 stars
churn-prevention SKILL.md skill
borghei/claude-skills · business-growth/churn-prevention/SKILL.md · SaaS churn reduction covering cancel flow design, dynamic save offers, exit survey architecture, dunning sequences…
v1.0.0 · audit A · 1,075 stars
commercial-policy SKILL.md skill
borghei/claude-skills · business-growth/commercial-policy/SKILL.md · Commercial policy: the governance framework defining what terms sales can offer and what triggers approval. Use when…
v1.0.0 · audit A · 1,075 stars
competitive-teardown SKILL.md skill
borghei/claude-skills · business-growth/competitive-teardown/SKILL.md · Systematic competitor analysis covering product teardowns, 12-dimension scoring rubric, feature comparison matrices…
v1.0.0 · audit A · 1,075 stars

Every file in borghei/claude-skills

Other files named pr-description-writer

pr-description-writer SKILL.md skill
mohitagw15856/pm-claude-skills · i18n/es/skills/pr-description-writer/SKILL.md · Redacta una descripción de pull request clara y estructurada a partir de un diff de git, resumen de rama o lista de…
git:20260702.b8fb11d · audit A · 1,475 stars
pr-description-writer SKILL.md skill
varnan-tech/opendirectory · skills/pr-description-writer/SKILL.md · Use when the user asks to write, draft, generate, or update a GitHub pull request description for the current branch…
v1.0.0 · audit A · 699 stars
pr-description-writer SKILL.md skill
lethe044/agentskill-kit · skills/pr-description-writer/SKILL.md · Drafts a pull request description with a summary, motivation, a change list, test notes and risks from a diff or commit…
v1.0.0 · audit A · 49 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/claude/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/grok/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/cursor/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · plugins/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars

Browse by kind, by grade A, or by owner.