pr-creator
Create pull requests with gh command after development is complete. Use when ready to open a PR.
When & Why to Use This Skill
The PR Creator skill automates the GitHub Pull Request workflow by leveraging the GitHub CLI (gh). It streamlines the transition from development to review by automatically analyzing branch changes, applying standardized templates for features, fixes, or documentation, and ensuring all PRs are linked to specifications for better project traceability and developer productivity.
Use Cases
- Automated PR Generation: Quickly generate a pull request draft after finishing a feature branch, ensuring the title and body follow team-standardized prefixes like 'feat:' or 'fix:'.
- Template Standardization: Automatically apply specific markdown templates for different types of contributions (features, bug fixes, refactors) to maintain high-quality documentation across the repository.
- Workflow Integration: Seamlessly bridge the gap between local coding and remote collaboration by analyzing diffs, finding related specifications, and executing the 'gh pr create' command through a guided AI workflow.
| name | pr-creator |
|---|---|
| description | Create pull requests with gh command after development is complete. Use when ready to open a PR. |
PR Creator Skill
Create a pull request after development on a branch is complete.
Development Types
| Type | Branch Pattern | Title Prefix | Draft | Template |
|---|---|---|---|---|
| Feature | feature/* |
feat: |
Yes | feature.md |
| Bug fix | fix/* |
fix: |
No | fix.md |
| Documentation | docs/* |
docs: |
No | docs.md |
| Refactoring | refactor/* |
refactor: |
Yes | refactor.md |
Guidelines
- Link the specification - Every PR must reference its specification
- One feature per PR - Keep PRs focused and small
- All tests must pass - Ensure CI is green
- Request a review - Wait for approval before merging
Workflow
- Analyze: Get branch name, commits (
main..HEAD), and diff to understand changes - Find spec: Look for related spec in
docs/specs/ - Draft: Generate title and body using the appropriate template
- Confirm: Show draft to user for approval
- Create: Push if needed, run
gh pr create - Report: Show PR URL