pr-prepare
Prepare pull request descriptions for template changes. Activates on: prepare PR, create PR, pull request, ready for PR, draft PR, write PR
When & Why to Use This Skill
This Claude skill automates the generation of professional and structured pull request descriptions, specifically optimized for template-based projects. By analyzing git status, commit history, and file diffs, it creates comprehensive summaries, impact reports, and testing checklists to ensure high-quality code reviews and standardized documentation.
Use Cases
- Automated PR Documentation: Quickly generate detailed pull request descriptions by automatically extracting context from git logs and diffs, saving developers time on manual writing.
- Standardizing Engineering Workflows: Maintain consistency across a development team by using a unified PR template that includes scope, impact analysis, and mandatory testing checkboxes.
- Template & Boilerplate Maintenance: Efficiently track and document changes in complex templates (like Cookiecutter), identifying modifications in variables, hooks, and generated project structures.
- Conventional Commit Integration: Improve repository health by generating suggested PR titles that follow conventional commit standards (e.g., feat, fix, chore) based on the analyzed changes.
| name | pr-prepare |
|---|---|
| description | "Prepare pull request descriptions for template changes. Activates on: prepare PR, create PR, pull request, ready for PR, draft PR, write PR" |
PR Preparation Skill
Automatically prepare pull request descriptions for template changes.
Activation
This skill activates on keywords:
- "prepare PR", "prepare the PR", "prepare a PR"
- "create PR", "create pull request"
- "PR description", "pull request description"
- "ready for PR", "ready to PR"
- "draft PR", "write PR"
Workflow
When activated, follow these steps:
1. Gather Context
Run these commands to understand the changes:
# Current state
git status
# Branch comparison
git log $(git merge-base HEAD main)..HEAD --oneline
# Files changed
git diff $(git merge-base HEAD main)..HEAD --stat
2. Analyze Template Changes
Identify:
- Scope: cookiecutter.json, hooks, template files, docs?
- Purpose: Why these changes were made
- Impact: Breaking changes for existing template users?
- Testing: Template generation tested?
3. Generate PR Description
Use this template format:
## Summary
[1-3 sentences: what changed and why]
## Changes
- **[Component]**: [What changed and why]
## Scope
- [ ] `cookiecutter.json` (template variables)
- [ ] `hooks/` (generation hooks)
- [ ] `{{cookiecutter.project_slug}}/` (generated project files)
- [ ] Documentation
## Impact
- ✅ [Key benefit]
- ✅ No breaking changes to existing template users
## Testing
- [ ] Template generates with default options
- [ ] Template generates with features enabled
- [ ] Generated project passes `uv run pytest`
## Notes
[Optional: known issues, follow-up work]
4. Suggest PR Title
Follow conventional commits with template scopes:
| Scope | When to Use |
|---|---|
feat(template): |
New template feature |
fix(hooks): |
Hook bug fix |
docs: |
Documentation |
chore(config): |
cookiecutter.json changes |
ci: |
Workflow changes |
5. Output
Present the complete PR description ready to copy-paste.
Remind the user:
- CodeRabbit will auto-fill summary
- Test template generation before pushing
Example Output
Suggested Title: feat(template): add CodeRabbit and Linear integrations
PR Description:
## Summary
Add CodeRabbit AI code reviews and Linear project management integration as optional features.
## Changes
- **cookiecutter.json**: New `include_coderabbit`, `include_linear`, `linear_team_key` variables
- **{{cookiecutter.project_slug}}/.coderabbit.yaml**: CodeRabbit configuration template
- **{{cookiecutter.project_slug}}/.github/PULL_REQUEST_TEMPLATE.md**: PR template with Linear support
- **hooks/post_gen_project.py**: Cleanup logic and success messages
## Scope
- [x] `cookiecutter.json` (template variables)
- [x] `hooks/` (generation hooks)
- [x] `{{cookiecutter.project_slug}}/` (generated project files)
- [x] Documentation
## Impact
- ✅ Projects can now use AI code reviews via CodeRabbit
- ✅ Linear integration for project management
- ✅ No breaking changes to existing template users
## Testing
- [x] Template generates with default options
- [x] Template generates with features enabled
- [x] Generated project structure validated
## Notes
CodeRabbit requires GitHub App installation after project creation.