pr-description

Generate Markdown PR descriptions from git diffs with test results.

Updated Oct 23, 2025
One-click install
npx skills add https://github.com/kis9a/claude-skills-demo --skill pr-description-kis9a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-description
Source: https://github.com/kis9a/claude-skills-demo/tree/main/.claude/skills/pr-description
Command: npx skills add https://github.com/kis9a/claude-skills-demo --skill pr-description-kis9a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes git diffs and generates a detailed PR description that aligns with team conventions and includes change summaries, test results, impact analysis, and verification steps.

Core Features & Use Cases

  • Diff analysis: analyzes changes by file and feature
  • PR body generation: produces sections for Summary, Changes, Test Results, Impact Analysis, Verification, and Rollback
  • Template compliance: can apply a standard PR template if available
  • Test results inclusion: includes relevant test outcomes

Quick Start

Run pr-description to generate a complete PR description from your current diff.

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 PR description from my git diff?

PR description generation analyzes changes between branches and produces a structured Markdown document with Summary, Changes, Test Results, Impact Analysis, Verification, and Rollback Plan sections. Run the Skill to automatically extract file-by-file and feature-by-feature changes and format them according to team conventions.

Can I include test results in my PR body?

Yes, the Skill includes relevant test outcomes as part of the PR body generation. It gathers test results alongside diff analysis and incorporates them into a dedicated Test Results section within the final Markdown document.

Does this work with PR templates?

The Skill applies a standard PR template if one is available in your repository. It adapts the generated description to align with your team's template structure while maintaining all required sections like Summary, Changes, and Impact Analysis.

What changes does the Skill analyze in a diff?

The Skill analyzes git diffs by file and by feature, classifying each change and assessing its impact. It reads diffs between branches (such as main...HEAD) and produces detailed change summaries organized by functional area.

Do I need to manually format the PR description after generation?

No, the Skill outputs a complete, structured Markdown document ready to use. The generated PR body follows team conventions and includes all standard sections—Summary, Changes, Test Results, Impact Analysis, Verification, and Rollback Plan—without requiring manual formatting.

What if my repository doesn't have a PR template?

The Skill generates a default structured PR body with standard sections even without a template file. It ensures consistent formatting and comprehensive coverage of changes, test results, and impact analysis using built-in conventions.