git-pr

SKILL.md

Generate PR Description

Create a comprehensive pull request description based on the branch diff.

Process

1. Gather Context

# Get current branch name
git branch --show-current

# Find base branch (usually main or master)
git remote show origin | grep 'HEAD branch'

# Get all commits on this branch
git log main..HEAD --oneline

# Get the full diff
git diff main...HEAD --stat
git diff main...HEAD

2. Analyze Changes

Categorize the changes:

  • Features: New functionality
  • Fixes: Bug fixes
  • Refactors: Code improvements without behavior change
  • Docs: Documentation updates
  • Tests: Test additions/changes
  • Chores: Dependencies, configs, tooling

3. Generate PR Description

Use this format:

## Summary

[2-3 sentences describing what this PR does and why]

## Changes

- [Bullet point for each logical change]
- [Group related file changes together]
- [Focus on what changed, not how]

## Type of Change

- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that causes existing functionality to change)
- [ ] Refactor (no functional changes)
- [ ] Documentation update

## Testing

[How was this tested? What should reviewers verify?]

- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing completed

## Screenshots (if applicable)

[Add screenshots for UI changes]

## Checklist

- [ ] My code follows the project's style guidelines
- [ ] I have performed a self-review
- [ ] I have added tests that prove my fix/feature works
- [ ] New and existing unit tests pass locally
- [ ] Any dependent changes have been merged

---

Generated with Claude Code

4. Determine Title

PR title format: type(scope): description

Examples:

  • feat(auth): add OAuth2 login support
  • fix(api): handle null response from payment service
  • refactor(db): extract query builder into separate module

5. Output

Provide:

  1. Suggested PR title
  2. Full PR description in markdown
  3. Suggested reviewers (if CODEOWNERS exists)
  4. Labels to add (if .github/labels.yml exists)

6. Create PR (Optional)

If user confirms, create the PR:

gh pr create --title "..." --body "..."

Guidelines

  • Focus on why over what (the diff shows what)
  • Link to related issues: Fixes #123 or Relates to #456
  • Call out breaking changes prominently
  • Mention any manual steps required post-merge
  • Keep bullet points scannable (one line each)
Weekly Installs
4
GitHub Stars
6
First Seen
11 days ago
Installed on
claude-code4
opencode3
gemini-cli3
github-copilot3
codex3
kimi-cli3