<< All versions
Skill v1.0.0
currentLLM-judged scan90/100hecaguilav/symbiosis/github-pr
──Details
PublishedOctober 23, 2026 at 02:40 PM
Content Hashsha256:3d6b67e0a360f4d9...
Git SHA5c5f54b35740
──Files
Files (1 file, 3.5 KB)
SKILL.md3.5 KBactive
SKILL.md · 212 lines · 3.5 KB
version: "1.0.0" name: github-pr description: > Create high-quality Pull Requests with conventional commits and proper descriptions. Trigger: When creating PRs, writing PR descriptions, or using gh CLI for pull requests. metadata: author: gentleman-programming version: "1.0"
When to Use
- Creating a new Pull Request
- Writing PR titles and descriptions
- Preparing commits for review
- Using
gh pr createcommand
Critical Patterns
PR Title = Conventional Commit
<type>(<scope>): <short description>feat New featurefix Bug fixdocs Documentationrefactor Code refactoringtest Adding testschore Maintenance
PR Description Structure
markdown
## Summary-1-3 bullet points explaining WHAT and WHY## Changes-List main changes## Testing-[ ] Tests added/updated-[ ] Manual testing doneCloses #123
Atomic Commits
bash
# Good: One thing per commitgit commit -m "feat(user): add User model"git commit -m "feat(user): add UserService"git commit -m "test(user): add UserService tests"# Bad: Everything in one commitgit commit -m "add user feature"
Code Examples
Basic PR Creation
bash
gh pr create \--title "feat(auth): add OAuth2 login" \--body "## Summary- Add Google OAuth2 authentication## Changes- Added AuthProvider component- Created useAuth hookCloses #42"
PR with HEREDOC (Complex Description)
bash
gh pr create --title "feat(dashboard): add analytics" --body "$(cat <<'EOF'## Summary- Add real-time analytics dashboard## Changes- Created AnalyticsProvider- Added LineChart, BarChart components## Testing- [x] Unit tests for components- [x] Manual testing complete## ScreenshotsCloses #123EOF)"
Draft PR
bash
gh pr create --draft \--title "wip: refactor auth" \--body "Work in progress"
PR with Reviewers and Labels
bash
gh pr create \--title "feat(api): add rate limiting" \--body "Adds rate limiting to API" \--reviewer "user1,user2" \--label "enhancement,api"
Commands
bash
# Create PRgh pr create --title "type(scope): desc" --body "..."# Create with web editorgh pr create --web# View PR statusgh pr status# View diffgh pr diff# Check CI statusgh pr checks# Merge with squashgh pr merge --squash# Add reviewergh pr edit --add-reviewer username
Anti-Patterns
Don't: Vague Titles
bash
# Badgh pr create --title "fix bug"gh pr create --title "update"# Goodgh pr create --title "fix(auth): prevent session timeout"
Don't: Giant PRs
bash
# Bad: 50 files, 2000+ lines in one PR# Good: Split into logical PRs# PR 1: feat(models): add User model# PR 2: feat(api): add user endpoints# PR 3: feat(ui): add user pages
Don't: Empty Descriptions
bash
# Bad--body "Added feature"# Good--body "## Summary- What you did and why## Changes- Specific changesCloses #123"
Quick Reference
| Task | Command | |
|---|---|---|
| Create PR | gh pr create -t "type: desc" -b "body" | |
| Draft PR | gh pr create --draft | |
| Web editor | gh pr create --web | |
| Add reviewer | --reviewer user1,user2 | |
| Add label | --label bug,high-priority | |
| Link issue | Closes #123 in body | |
| View status | gh pr status | |
| Merge squash | gh pr merge --squash |