pr-description

Generate a structured Markdown PR description from a branch diff.

4|Updated Mar 6, 2026

Search Tags:#documentation #ai-assistant #code-review #structured-output #pull-request #pr-description #branch-diff

Ready to run

npx skills add https://github.com/accolver/skill-maker --skill pr-description-accolver

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pr-description
Source: https://github.com/accolver/skill-maker/tree/main/pr-description
Command: npx skills add https://github.com/accolver/skill-maker --skill pr-description-accolver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually crafting PR descriptions from branch changes is time-consuming and error-prone; this skill automates the creation of comprehensive, reviewer-friendly PR bodies that explain motivation, scope, and risk.

Core Features & Use Cases

Structured PR descriptions including motivation, grouped changes by concept, testing instructions, rollback plan, and reviewer guidance.
Works for features, bugfixes, and refactors by deriving context from a branch diff and linked tickets.
Enables copy-pasteable, reviewer-ready descriptions that speed up code reviews and approvals.

Quick Start

Provide the branch diff to the skill and it will generate a structured PR description with motivation, changes grouped by concept, testing instructions, rollback plan, and reviewer notes.

Frequently Asked Questions about pr-description

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate a structured pull request description from a branch diff?▼

A good PR description explains motivation, groups changes by concept, and provides copy-pasteable testing instructions. This ensures reviewers understand the scope and risk, speeding up code reviews and approvals.

Can I automatically group pull request changes by concept instead of by file?▼

You can create reviewer-ready PR descriptions by providing the branch diff and linked tickets. The tool derives context to produce a Markdown body with summary, motivation, changes, testing instructions, rollback plan, and reviewer notes.

Does this tool work for generating PR descriptions for bug fixes and refactors?▼

The generated PR description includes sections for Summary, Motivation, Changes, Testing Instructions, Rollback Plan, and Reviewer Notes. It references related tickets when available to provide complete reviewer guidance.

What is the best way to include testing instructions and a rollback plan in a PR body?▼

The best way to include testing instructions and a rollback plan in a PR body is to generate them from a branch diff. The tool outputs copy-pasteable testing instructions and a rollback plan within the Markdown description.