PR Automation Skill
Automate pull request workflows to streamline PR creation and validation.
When to Use
Use this skill when:
- Before creating a PR
- When user requests PR creation
- Before pushing code to remote
- After completing a feature or fix
Capabilities
1. Generate PR Descriptions
Automatically generate comprehensive PR descriptions:
- Analyze git diff to understand changes
- Extract commit messages for context
- Identify changed files and their purposes
- Generate structured PR description following template
- Include all required sections (description, changes, testing, etc.)
2. Validate PR Requirements
Check PR requirements before creation:
- Verify tests exist for new features
- Check that tests pass
- Verify documentation is updated
- Validate code follows project conventions
- Check for linting errors
- Verify formatting is correct
- Ensure no secrets or credentials are committed
3. Check for Missing Tests/Docs
Identify missing requirements:
- Check if new features have tests
- Verify documentation is updated
- Check for missing type hints (Python)
- Verify error handling is documented
- Check for missing API documentation
4. Link Issues Automatically
Automatically link related issues:
- Parse commit messages for issue references (#123)
- Search for related issues based on changes
- Add "Closes #123" or "Related to #123" to PR description
- Link to parent issues or epics
5. Suggest Reviewers
Suggest appropriate reviewers:
- Based on files changed (domain expertise)
- Based on previous reviewers of similar changes
- Based on code owners (if CODEOWNERS file exists)
- Based on team structure
Workflow
- Analyze Changes: Review git diff and commit history
- Generate Description: Create comprehensive PR description
- Run Validation: Check all PR requirements
- Fix Issues: Address any validation failures
- Create PR: Generate PR with all information
- Post-Creation: Add labels, assign reviewers, link issues
PR Description Template
Follows the template from .cursor/rules/context-communication.mdc:
- Description of what changed and why
- Related issue links
- List of changes
- How it was verified
- Related code references
- Assumptions made
- Breaking changes (if any)
- Testing checklist
Related Resources
Rules
.cursor/rules/git-workflow.mdc- Git workflow and PR process.cursor/rules/context-communication.mdc- PR description best practices.cursor/rules/testing.mdc- Testing requirements
Subagents
.cursor/agents/pr-manager.md- PR management subagent.cursor/agents/code-reviewer.md- Code review subagent.cursor/agents/test-runner.md- Test runner subagent
Commands
/auto-pr- Generate PR with automation/pr- Create pull request with proper description/code-review- Review code before PR