github-pr-manager

GitHub PR Manager Skill

Overview

Manage the complete pull request lifecycle with swarm coordination. This skill handles PR creation, multi-reviewer coordination, automated testing integration, conflict resolution, and intelligent merge strategies.

Quick Start

# Check GitHub CLI authentication
gh auth status

# Create a PR with description
gh pr create --title "Feature: New API endpoint" --body "Implementation details..." --base main

# Review PR status
gh pr status

# List open PRs
gh pr list --state open

When to Use

• Creating and managing pull requests
• Coordinating multi-reviewer workflows
• Resolving merge conflicts
• Automating PR testing and validation
• Managing branch synchronization
• Batch PR operations across repositories

Core Capabilities

Usage Examples

1. Create PR with Swarm Coordination

// Initialize review swarm
mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 4 })
mcp__claude-flow__agent_spawn({ type: "reviewer", name: "Code Quality Reviewer" })
mcp__claude-flow__agent_spawn({ type: "tester", name: "Testing Agent" })
mcp__claude-flow__agent_spawn({ type: "coordinator", name: "PR Coordinator" })

// Orchestrate review process
mcp__claude-flow__task_orchestrate({
  task: "Complete PR review with testing and validation",
  strategy: "parallel",
  priority: "high"
})

2. Create and Manage PR with gh CLI

# Create PR
gh pr create \
  --repo owner/repo \
  --title "feat: Integration between packages" \
  --head feature-branch \
  --base main \
  --body "## Summary
- Added new integration
- Updated dependencies
- Fixed compatibility issues"

# View PR details
gh pr view 54 --json files,additions,deletions,title,body

# Add reviewers
gh pr edit 54 --add-reviewer user1,user2

# Check PR status
gh pr checks 54

3. Review and Approve PR

# Get PR diff
gh pr diff 54

# Approve PR
gh pr review 54 --approve --body "LGTM! All checks pass."

# Request changes
gh pr review 54 --request-changes --body "Please address the following..."

# Comment on PR
gh pr comment 54 --body "Consider refactoring this section."

4. Merge PR with Validation

# Check merge readiness
gh pr status

# Merge with squash
gh pr merge 54 --squash --delete-branch \
  --subject "feat: Complete integration" \
  --body "Comprehensive integration with swarm coordination"

# Merge with rebase
gh pr merge 54 --rebase --delete-branch

5. Batch PR Operations

[Single Message - Complete PR Management]:
  // Initialize coordination
  mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 5 })
  mcp__claude-flow__agent_spawn({ type: "reviewer", name: "Senior Reviewer" })
  mcp__claude-flow__agent_spawn({ type: "tester", name: "QA Engineer" })
  mcp__claude-flow__agent_spawn({ type: "coordinator", name: "Merge Coordinator" })

  // Create and manage PR
  Bash("gh pr create --repo owner/repo --title '...' --head '...' --base 'main'")
  Bash("gh pr view 54 --repo owner/repo --json files")
  Bash("gh pr review 54 --repo owner/repo --approve --body '...'")

  // Execute tests and validation
  Bash("npm test && npm run lint && npm run build")

  // Track progress
  TodoWrite({ todos: [
    { id: "review", content: "Complete code review", status: "completed" },
    { id: "test", content: "Run test suite", status: "completed" },
    { id: "merge", content: "Merge when ready", status: "pending" }
  ]})

MCP Tool Integration

Swarm Initialization

mcp__claude-flow__swarm_init({
    topology: "mesh",  // mesh, hierarchical, star, ring
    maxAgents: 4,
    strategy: "balanced"
})

Agent Spawning

mcp__claude-flow__agent_spawn({
    type: "reviewer",
    name: "PR Reviewer",
    capabilities: ["code-review", "security-audit", "performance-check"]
})

Memory Coordination

// Store PR state
mcp__claude-flow__memory_usage({
    action: "store",
    key: "pr/54/status",
    value: JSON.stringify({
        timestamp: Date.now(),
        status: "approved",
        reviewers: ["user1", "user2"]
    })
})

// Retrieve PR state
mcp__claude-flow__memory_usage({
    action: "retrieve",
    key: "pr/54/status"
})

Best Practices

1. Always Use Swarm Coordination

• Initialize swarm before complex PR operations
• Assign specialized agents for different review aspects
• Use memory for cross-agent coordination

2. Batch PR Operations

• Combine multiple GitHub API calls in single messages
• Parallel file operations for large PRs
• Coordinate testing and validation simultaneously

3. Intelligent Review Strategy

• Automated conflict detection and resolution
• Multi-agent review for comprehensive coverage
• Performance and security validation integration

4. Progress Tracking

• Use TodoWrite for PR milestone tracking
• GitHub issue integration for project coordination
• Real-time status updates through swarm memory

Error Handling

Automatic retry logic for:

• Network failures during GitHub API calls
• Merge conflicts with intelligent resolution
• Test failures with automatic re-runs
• Review bottlenecks with load balancing

Swarm coordination ensures:

• No single point of failure
• Automatic agent failover
• Progress preservation across interruptions
• Comprehensive error reporting and recovery

Integration with Other Skills

Hooks

Pre-Task Hooks

gh auth status || (echo 'GitHub CLI not authenticated' && exit 1)
git status --porcelain
gh pr list --state open --limit 1 >/dev/null || echo 'No open PRs'
npm test --silent || echo 'Tests may need attention'

Post-Task Hooks

gh pr status || echo 'No active PR in current branch'
git branch --show-current
gh pr checks || echo 'No PR checks available'
git log --oneline -3

Version History

• 1.0.0 (2025-01-02): Initial release - converted from pr-manager agent