What format does the PR description follow?

The skill generates a standardized three-part structure consisting of # Problem (context), # Solution (implementation details), and # Test Plan (verification steps).

Does it work with large codebases?

Yes, though for extremely large changes, the skill will provide advice on splitting the PR to ensure the description remains focused and high-quality.

Can I generate descriptions in different languages?

Yes, the skill supports both English ('en') and Chinese ('zh') output for the generated descriptions.

How does it determine which changes to include?

It uses git commands to analyze the diff between your current HEAD and your target branch (typically master or main) to capture all relevant changes.

Smart PR Description Generator

Name: Smart PR Description Generator
Author: futuretea

byfuturetea

0•

Collaboration Tools

Generates structured, professional Pull Request descriptions by analyzing git diffs using the Problem/Solution/Test Plan framework.

The Smart PR Description Generator automates the documentation of code changes to streamline the review process. By analyzing git diffs and commit statistics against a target branch, it produces high-quality descriptions organized into three critical sections: the problem context, the implemented solution, and a detailed test plan. This skill ensures consistency across team repositories and saves developers significant time by transforming technical changes into readable, actionable summaries for reviewers.

Key Features

01Supports bilingual output in English and Chinese

020 GitHub stars

03Generates structured Problem/Solution/Test Plan formatting

04Identifies default branches to compare head changes accurately

05Provides smart error handling for large diffs or missing branches

06Analyzes git diffs and commit statistics automatically

Use Cases

01Quickly summarizing complex refactors for peer review

02Standardizing PR documentation across a large engineering team

03Generating comprehensive manual test plans for QA verification

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add futuretea/code-assistant pr-description

For use in Claude.ai and ChatGPT

Download Skill