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 transition from local development to code review by streamlining the GitHub pull request process. It leverages the GitHub CLI (gh) to analyze branch commits and diffs, perform pre-flight verification, and generate standardized PRs using predefined templates for features, bug fixes, and documentation, ensuring consistency and quality in the development workflow.
Use Cases
- Standardizing PR Documentation: Automatically generate structured pull request titles and bodies using templates (feat, fix, docs, refactor) to maintain a clean and professional repository history.
- Automated Pre-submission Checks: Integrate local CI commands like 'make preflight' into the PR creation workflow to ensure code passes basic tests before it ever reaches a reviewer.
- Workflow Efficiency: Rapidly create draft pull requests directly from the terminal or agent interface, automatically linking relevant technical specifications and summarizing code changes for faster reviews.
| 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 | Template |
|---|---|---|---|
| Feature | feature/* |
feat: |
feature.md |
| Bug fix | fix/* |
fix: |
fix.md |
| Documentation | docs/* |
docs: |
docs.md |
| Refactoring | refactor/* |
refactor: |
refactor.md |
Guidelines
- Link the specification - Every PR must reference its specification
- One feature per PR - Keep PRs focused and small
- 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/ - Preflight: Run
make preflightto verify CI checks pass - Draft: Generate title and body using the appropriate template
- Create: Push if needed, run
gh pr create --draft - Report: Show PR URL