Agent skill
pr-create
Create well-structured pull requests with proper descriptions
Install this agent skill to your Project
npx add-skill https://github.com/48Nauts-Operator/opencode-baseline/tree/main/.opencode/skill/pr-create
Metadata
Additional technical details for this skill
- audience
- developers
- workflow
- git
SKILL.md
PR Create
Create well-structured pull requests with comprehensive descriptions, proper linking, and review-ready formatting.
When to Use
- Ready to submit code for review
- Need to create PR from current branch
- Want consistent PR formatting across team
How to Use
Create a PR for this branch
Create PR targeting develop branch
Create draft PR with WIP changes
Process
1. Gather Context
# Current branch and status
git status
git branch --show-current
# Commits to include
git log main..HEAD --oneline
# Full diff
git diff main...HEAD --stat
2. Analyze Changes
- Identify primary change type (feature, fix, refactor)
- List affected components/modules
- Note breaking changes
- Check for related issues
3. Generate PR
gh pr create --title "feat: add user authentication" --body "$(cat <<'EOF'
## Summary
Brief description of what this PR does and why.
## Changes
- Added JWT authentication middleware
- Created login/logout endpoints
- Updated user model with password hashing
## Testing
- [ ] Unit tests added
- [ ] Integration tests pass
- [ ] Manual testing completed
## Screenshots
(if applicable)
## Related Issues
Closes #123
EOF
)"
PR Template
## Summary
<!-- What does this PR do? Why is it needed? -->
## Type of Change
- [ ] Bug fix (non-breaking change fixing an issue)
- [ ] New feature (non-breaking change adding functionality)
- [ ] Breaking change (fix or feature causing existing functionality to change)
- [ ] Documentation update
- [ ] Refactoring (no functional changes)
## Changes Made
<!-- List the main changes -->
-
-
-
## Testing
<!-- How was this tested? -->
- [ ] Unit tests added/updated
- [ ] Integration tests pass
- [ ] Manual testing completed
## Checklist
- [ ] Code follows project style guidelines
- [ ] Self-review completed
- [ ] Comments added for complex logic
- [ ] Documentation updated (if needed)
- [ ] No new warnings introduced
## Screenshots
<!-- If applicable, add screenshots -->
## Related Issues
<!-- Link related issues: Closes #123, Fixes #456 -->
## Notes for Reviewers
<!-- Any specific areas to focus on? Context needed? -->
Title Conventions
Format: <type>: <description>
| Type | Use For |
|---|---|
| feat | New feature |
| fix | Bug fix |
| docs | Documentation only |
| style | Formatting, no code change |
| refactor | Code change, no feature/fix |
| perf | Performance improvement |
| test | Adding tests |
| chore | Maintenance, dependencies |
Examples:
feat: add dark mode togglefix: resolve login timeout issuerefactor: simplify auth middleware
Options
# Draft PR
gh pr create --draft
# Assign reviewers
gh pr create --reviewer @teammate
# Add labels
gh pr create --label "enhancement"
# Target specific branch
gh pr create --base develop
# Auto-merge when checks pass
gh pr merge --auto --squash
Best Practices
- Small PRs - easier to review, faster to merge
- One concern per PR - don't mix features with refactoring
- Descriptive title - summarize the change in <72 chars
- Link issues - use "Closes #123" for auto-linking
- Screenshots - include for UI changes
- Test evidence - show tests pass or describe manual testing
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
file-organizer
Organize files and folders intelligently with duplicate detection
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.
auth-implementation-patterns
Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.
sql-optimization-patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
monorepo-management
Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use when setting up monorepos, optimizing builds, or managing shared dependencies.
git-advanced-workflows
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.
Didn't find tool you were looking for?