skills.rest
atomicinnovation
atomicinnovationOFFICIAL
Explore all skills by this author →
GitHub

describe-pr

Generate pull request descriptions from diffs, commits, and templates.

30|1|Updated Mar 15, 2026
Search Tags:#template#github#code-review#pull-request#gh-cli#pr-description#diff-analysis
One-click install
npx skills add https://github.com/atomicinnovation/accelerator --skill describe-pr-atomicinnovation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: describe-pr
Source: https://github.com/atomicinnovation/accelerator/tree/main/skills/github/describe-pr
Command: npx skills add https://github.com/atomicinnovation/accelerator --skill describe-pr-atomicinnovation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates creating comprehensive, repository-standard pull request descriptions so maintainers and reviewers get a clear, scannable summary of what changed, why, and how to verify it without manual drafting.

Core Features & Use Cases

  • Template-driven descriptions: Reads the local PR description template and fills each section with targeted content derived from the PR diff, commits, and metadata.
  • Deep diff and impact analysis: Inspects full PR diffs and referenced files to surface user-facing changes, architectural impacts, and potential migration or breaking-change notes.
  • Verification & posting support: Runs verification commands when available, marks checklist items, persists draft descriptions to the configured prs directory, and prepares the cleaned body for gh pr edit.
  • Use Case: Prepare a high-quality PR description before merging a feature branch so reviewers can focus on key decisions, tests, and migration steps.

Quick Start

Generate a PR description for pull request 42 by analyzing its diff, filling the repository PR template, and preparing the body for posting to GitHub.

Frequently Asked Questions about describe-pr

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

FAQPage Schema
How do I generate a pull request description from a git diff automatically?▼

Generate a pull request description from a git diff automatically by reading the repository PR template, extracting the full diff and commit history with gh, and populating template sections to produce a comprehensive, ready-to-post PR body.

How do I fill out a GitHub PR template using commit history and diff metadata?▼

Fill out a GitHub PR template by analyzing commit history and diff metadata to surface user-facing changes, architectural impacts, and migration notes, then automatically populating each template section with targeted content derived from the PR data.

Can I use gh CLI to extract PR diffs and populate a PR description template?▼

Yes, you can use gh CLI to extract PR diffs and populate a PR description template by running commands to pull the full diff and commit history, then mapping that data into the repository's local template sections for a complete description.

What is the best way to automate code review documentation for breaking changes?▼

Automate code review documentation for breaking changes by inspecting full PR diffs and referenced files to surface potential migration impacts, then generating a scannable PR summary that highlights architectural changes for maintainers and reviewers.

Does this PR description generator run verification commands before drafting the summary?▼

Yes, the PR description generator runs available verification commands before drafting the summary, marks checklist items based on the results, and persists the draft description to the configured prs directory with YAML frontmatter for later posting.

How do I prepare a cleaned PR body for gh pr edit from a local draft?▼

Prepare a cleaned PR body for gh pr edit by generating the description from diffs and metadata, saving it to the configured prs directory with YAML frontmatter, and formatting the final text so it is ready to post directly to GitHub.

Related Skills

Explore More Software Engineering Skills→
JohnWebb4JohnWebb4

dev-workflow-write-pr

Automates GitHub pull-request creation by analyzing diffs and generating descriptions from templates.

Community
Advanced
dnlopesdnlopes

creating-pull-requests

Generate conventional pull request titles and descriptions for GitHub CLI.

Community
Intermediate
miounet11miounet11

Git Smart Commit

Generate conventional commit messages from staged Git changes.

Community
Intermediate
abretonc7sabretonc7s

pr-description

Generate pull request descriptions from branch, diff, and commit data.

Community
Advanced