update-pr

Generate structured Markdown PR summaries from branch changes and update via gh CLI.

2|Updated Nov 13, 2025
One-click install
npx skills add https://github.com/propstreet/claude-powerpack --skill update-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-pr
Source: https://github.com/propstreet/claude-powerpack/tree/main/skills/update-pr
Command: npx skills add https://github.com/propstreet/claude-powerpack --skill update-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually writing comprehensive Pull Request (PR) descriptions is a tedious, time-consuming task that often leads to overlooked changes, slowing down code reviews and increasing the risk of bugs. This Skill automates the entire process, ensuring every meaningful change is documented.

Core Features & Use Cases

  • Systematic Change Inventory: Automatically inventories ALL changed files and commits, categorizing them into features, bug fixes, tests, documentation, and configuration updates.
  • Structured PR Summaries: Generates well-organized PR descriptions with dedicated sections for user impact, technical notes, testing details, and the implementation approach.
  • GitHub Integration: Seamlessly updates your GitHub Pull Request description via the gh pr edit command, saving you manual copy-pasting.
  • Use Case: A developer finishes a complex feature branch that also includes several bug fixes, refactors, and new tests. Instead of spending an hour manually documenting everything, they use this Skill to generate a complete, structured PR description in minutes, ensuring nothing is missed and accelerating the review process.

Quick Start

Update the PR description for this branch.

Frequently Asked Questions about update-pr

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

FAQPage Schema
How do I automate writing pull request descriptions?

Automate PR descriptions by analyzing all changed files and commits in your branch, then generating a structured summary that documents features, fixes, tests, and configuration changes. This Skill inventories changes, categorizes them by type, and updates your GitHub PR via gh CLI automatically.

Can I use GitHub automation to save time on code reviews?

Yes. Automating PR descriptions ensures comprehensive documentation of all changes upfront, reducing reviewer time spent understanding intent. This Skill generates well-organized summaries covering user impact, technical notes, and testing details, accelerating the review process.

What changes does the Skill document in a pull request?

The Skill documents features, bug fixes, tests, documentation updates, and configuration changes. It analyzes commits for intent and impact, inventories all changed files, and produces a Markdown summary with dedicated sections for each change category.

Does this work with gh CLI and Git workflows?

Yes. This Skill requires gh CLI and Git from a POSIX shell. It generates a Markdown summary saved to /tmp/pr-summary.md and updates your PR description via gh pr edit, integrating seamlessly into GitHub-based Git workflows.

When should I use automated PR descriptions instead of writing manually?

Use automated PR descriptions when preparing complex feature branches with multiple bug fixes, refactors, or tests. Automation ensures nothing is missed, eliminates manual documentation overhead, and produces consistent, structured summaries faster than writing them by hand.

What's the best way to document branch changes across multiple commit types?

Systematically inventory all changed files and commits, categorizing them by type—features, fixes, tests, docs, configuration. This Skill performs this categorization automatically and generates a structured summary, ensuring all change types are documented comprehensively.