A Python-based tool that automates the creation of structured pull request descriptions by analyzing git diffs and commit history.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pr-description-generator
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pr-description-generator using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PR Description Generator?
The PR Description Generator is a powerful utility designed for developers who want to streamline their pull request workflow. By leveraging Openclaw Skills, this tool parses your commit history—specifically favoring conventional commits—to categorize changes into features, fixes, and refactors. It saves time by automatically generating a cohesive narrative of what changed, why it changed, and what reviewers should focus on.
This skill ensures consistency across team contributions by providing standardized templates. Whether you need a quick summary or a deep-dive analysis of a large feature branch, the PR Description Generator provides the necessary context without manual writing effort, making it a vital addition to the Openclaw Skills library.
PR Description Generator Use Cases
- When you need to generate PR descriptions quickly for a branch with many commits.
- Creating standardized pull request summaries for team-wide consistency.
- Summarizing complex git changes into readable features, fixes, and refactors.
- Preparing detailed PR bodies for cross-team reviews that require impact analysis and test plans.
How PR Description Generator Works
- The skill analyzes the git diff between your current branch and a base branch (defaulting to main or master).
- It parses the commit history to identify conventional commit patterns for better categorization.
- Changes are automatically grouped by type, such as code, documentation, infrastructure, or dependencies.
- An impact analysis score is calculated based on the size and risk of the file changes.
- The generator applies the selected template (minimal, standard, or detailed) to produce the final description.
- The resulting output can be printed to the terminal, saved to a file, or copied to your clipboard.
PR Description Generator Setup
To start using this tool within the Openclaw Skills ecosystem, ensure you have Python 3 and the Git CLI installed. Run the following commands to generate descriptions:
# Generate a standard description for the current branch
python3 scripts/generate_pr_description.py
# Generate a detailed report comparing against a specific branch
python3 scripts/generate_pr_description.py --base develop --template detailed
# Save the output directly to a file
python3 scripts/generate_pr_description.py --output pr-body.md
PR Description Generator Data Schema & Taxonomy
The PR Description Generator organizes data based on the following metadata and output formats:
| Data Point | Description |
|---|---|
| Change Type | Categorized via conventional commits (feat, fix, refactor) |
| File Groups | Files grouped by purpose (e.g., tests, docs, database, config) |
| Impact Level | High, Medium, or Low risk assessment based on change size |
| Format | Output supports Markdown (.md) or structured JSON |
| Reviewer Hints | Automated warnings for missing tests or infrastructure changes |
PR Description Generator Advanced Features
- Auto-detection of base branches (main vs master) to simplify command execution.
- Automated test plan generation based on the specific types of files modified in the diff.
- Multi-template support including minimal bullet points or detailed file-by-file breakdowns.
- Clipboard integration for instant pasting into GitHub, GitLab, or Bitbucket interfaces.
- Native JSON output support for integration into larger CI/CD pipelines using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Gojek Company Research Skill
A specialized research skill for analyzing Gojek’s ecosystem, from its origins as a motorcycle hailing service to its evolution into the GoTo Group super app powerhouse.
F1 Formula Analysis
A specialized analytical tool for understanding the business evolution, economic structure, and global expansion of Formula 1 racing.
Hewlett-Packard Knowledge Base
An expert analysis skill covering the historical evolution, business logic, and market position of HP Inc.
Crypto Guardian
A comprehensive security framework designed to protect cryptocurrency wallets and private keys managed by AI agents from theft and exposure.
Verified Agent Identity
A comprehensive toolkit for AI agents to manage decentralized identities, sign challenges, and establish verifiable links to human owners on the Billions Network.
Secrets Audit
A high-performance security scanner for detecting hardcoded credentials, API keys, and sensitive tokens within codebases and git histories.
Featured*
