skills.rest
xriu
xriuCOMMUNITY
Explore all skills by this author →
GitHub

pr-full

Generate comprehensive pull request descriptions with verification results and impact analysis.

2|2|Updated Dec 23, 2017
Search Tags:#git#code review#documentation#pull request#github#generate#pr description
One-click install
npx skills add https://github.com/xriu/dotfiles --skill pr-full-xriu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-full
Source: https://github.com/xriu/dotfiles/tree/main/home/.skills/pr-full
Command: npx skills add https://github.com/xriu/dotfiles --skill pr-full-xriu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing thorough pull request descriptions is time-consuming, and reviewers often lack the context needed to evaluate changes, verification results, and impact. This Skill automates the creation of detailed PR documentation directly from git history and diffs. ## Core Features & Use Cases - Commit and Diff Analysis: Runs git log and git diff to gather commit history and change context automatically. - Categorized Change Summaries: Groups changes by type (bug fixes, features, refactoring, performance) with consistent icon labeling. - Verification and Metrics Tables: Includes verification checklists, commit tables, and before/after code quality metrics in a structured template. - Use Case: After finishing a feature branch with multiple commits, ask for a full PR description and receive a reviewer-ready document with summaries, verification results, and breaking change notes. ## Quick Start Ask the assistant to generate a comprehensive PR description for the current branch compared to main, including verification results and impact analysis.

Frequently Asked Questions about pr-full

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

FAQPage Schema
How do I generate a detailed pull request description automatically?▼

Provide the base and head branches, and the Skill runs git log and git diff to gather commits and changes. It then categorizes the changes, runs verification checks, and formats everything into a structured PR template.

What should a comprehensive PR description include?▼

A thorough PR description includes a brief summary, categorized changes with icons, verification results, a commit table, code quality metrics, breaking change notes, and testing checklists. This Skill's template covers all of these sections.

Does this work with GitHub pull requests?▼

Yes, the workflow supports GitHub by using gh pr diff to gather change context alongside standard git commands. The generated markdown output can be pasted directly into a GitHub PR body.

Can I customize the PR template categories?▼

The template uses predefined categories like bug fixes, features, refactoring, and performance with matching icons. You can adjust the markdown template sections in the output to fit your team's conventions.

What are the limitations of automated PR description generation?▼

The Skill relies on commit messages and diffs, so vague commit messages produce less informative summaries. Verification results and metrics must actually be gathered during the workflow, and business context still requires human input.

Related Skills

Explore More Software Engineering Skills→
imvanzenimvanzen

commit-series-on-branch

Creates commits on-demand from GitHub and/or GitLab events and webhooks. Fetches metadata for each commit and forwards it to the specified URL.

Community
Advanced
cookeyholdercookeyholder

squash-pr

Squash and merge a GitHub pull request into main after validating review feedback.

Community
Advanced
KimjimanKimjiman

verification-loop

Run build, type, lint, test, security, and diff checks before pull requests.

Community
Advanced
pedronauckpedronauck
601

ship-pr

Automates the end-of-feature workflow of generating release notes, writing PR descriptions, committing, and opening GitHub PRs.

Community
Advanced