Help us improve
Share bugs, ideas, or general feedback.
From github-orchestration
Generates GitHub PR descriptions from commits/issues with type-based templates, automates creation, review requests, metadata updates, and lifecycle management.
npx claudepluginhub constellos/claude-code --plugin github-orchestrationHow this skill is triggered — by the user, by Claude, or both
Slash command
/github-orchestration:pr-workflowThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Complete PR lifecycle management with auto-generated descriptions from commits and issues.
Guides PR creation, review automation, and merge strategies with templates, size/CI gates, and stale-PR notifications. Useful for enforcing consistent PR workflows.
Creates GitHub pull requests with formatted descriptions, labels, issue references, draft mode, reviewers, and base branch selection from pushed branches. Use for 'create PR' or 'submit for review'.
Guides full pull request lifecycle: creating PRs linked to issues with descriptions, adding labels/reviewers via scripts, fetching/handling review comments, and merging.
Share bugs, ideas, or general feedback.
Complete PR lifecycle management with auto-generated descriptions from commits and issues.
PR Workflow provides systematic pull request management with intelligent description generation, template selection based on work type, and automated review requests.
# Get commits since base branch
COMMITS=$(git log main..HEAD --oneline --no-decorate)
# Get linked issue
BRANCH=$(git branch --show-current)
ISSUE=$(extractIssueNumber "$BRANCH")
# Generate description
DESC=$(generatePRDescription "$COMMITS" "$ISSUE")
# Create PR
gh pr create --title "Add authentication system" --body "$DESC"
Utilities:
generatePRDescription(commits, linkedIssue?) - Auto-generate from commitsgetPRTemplateByWorkType(workType) - Get template by typerenderPRTemplate(template, vars) - Substitute variablesgroupCommitsByType(commits) - Group by conventional commit typesformatGroupedCommits(grouped) - Format as sectionsTemplates automatically adapt to work type:
Feature PR:
## Summary
Brief overview
## Changes
- Change 1
- Change 2
## Testing
- [ ] Unit tests
- [ ] Integration tests
## Related Issues
Closes #42
Bug Fix PR:
## Bug Fix
Brief description
## Root Cause
What caused it
## Solution
How we fixed it
## Testing
- [ ] Bug reproduced before fix
- [ ] Bug resolved after fix
# Auto-request reviewers from CODEOWNERS
OWNERS=$(grep "^$(dirname $FILE)" .github/CODEOWNERS | awk '{print $2}')
gh pr edit $PR --add-reviewer "$OWNERS"
# Or manually
gh pr edit $PR --add-reviewer @user1,@user2
# Update labels
gh pr edit 42 --add-label "enhancement,priority:high"
# Update milestone
gh pr edit 42 --milestone "v2.0"
# Convert to draft
gh pr ready --undo 42
# Mark ready for review
gh pr ready 42
getFeaturePRTemplate() - New featuresgetBugfixPRTemplate() - Bug fixesgetChorePRTemplate() - MaintenancegetDocsPRTemplate() - DocumentationgetRefactorPRTemplate() - Code improvementsAll templates include:
# Get commits
COMMITS=$(git log main..HEAD --pretty=format:"%s")
# Group by type
GROUPED=$(groupCommitsByType "$COMMITS")
# Returns: { feat: [...], fix: [...], docs: [...] }
# Format as sections
BODY=$(formatGroupedCommits "$GROUPED")
# Add issue reference
ISSUE=$(extractIssueNumber "$(git branch --show-current)")
BODY="$BODY
## Related Issues
Closes #$ISSUE"
# Create PR
gh pr create --title "Authentication system" --body "$BODY"
# Create PR and enable auto-merge
PR=$(gh pr create --title "..." --body "..." --json number -q .number)
# Enable auto-merge (squash)
gh pr merge $PR --auto --squash --delete-branch
# CI will auto-merge when checks pass
# Parse CODEOWNERS for file
FILE="src/auth/login.ts"
PATTERN=$(grep -E "^[^#].*$(dirname $FILE)" .github/CODEOWNERS | head -1)
REVIEWERS=$(echo "$PATTERN" | awk '{for(i=2;i<=NF;i++) print $i}' | tr '\n' ',' | sed 's/,$//')
# Request review
gh pr edit $PR --add-reviewer "$REVIEWERS"