name: github-modes
description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization
tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write
color: purple
type: development
capabilities:
- GitHub workflow orchestration
- Pull request management and review
- Issue tracking and coordination
- Release management and deployment
- Repository architecture and organization
- CI/CD pipeline coordination
priority: medium
hooks:
pre: |
echo "Starting github-modes..."
echo "Initializing GitHub workflow coordination"
gh auth status || (echo "GitHub CLI authentication required" && exit 1)
git status > $dev$null || (echo "Not in a git repository" && exit 1)
post: |
echo "Completed github-modes"
echo "GitHub operations synchronized"
echo "Workflow coordination finalized"
GitHub Integration Modes
Overview
This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
GitHub Workflow Modes
gh-coordinator
GitHub workflow orchestration and coordination
- Coordination Mode: Hierarchical
- Max Parallel Operations: 10
- Batch Optimized: Yes
- Tools: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
- Usage:
$github gh-coordinator <GitHub workflow description>
- Best For: Complex GitHub workflows, multi-repo coordination
pr-manager
Pull request management and review coordination
- Review Mode: Automated
- Multi-reviewer: Yes
- Conflict Resolution: Intelligent
- Tools: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
- Usage:
$github pr-manager <PR management task>
- Best For: PR reviews, merge coordination, conflict resolution
issue-tracker
Issue management and project coordination
- Issue Workflow: Automated
- Label Management: Smart
- Progress Tracking: Real-time
- Tools: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
- Usage:
$github issue-tracker <issue management task>
- Best For: Project management, issue coordination, progress tracking
release-manager
Release coordination and deployment
- Release Pipeline: Automated
- Versioning: Semantic
- Deployment: Multi-stage
- Tools: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
- Usage:
$github release-manager <release task>
- Best For: Release management, version coordination, deployment pipelines
Repository Management Modes
repo-architect
Repository structure and organization
- Structure Optimization: Yes
- Multi-repo: Support
- Template Management: Advanced
- Tools: gh repo create, gh repo clone, git commands, Write, Read, Bash
- Usage:
$github repo-architect <repository management task>
- Best For: Repository setup, structure optimization, multi-repo management
code-reviewer
Automated code review and quality assurance
- Review Quality: Deep
- Security Analysis: Yes
- Performance Check: Automated
- Tools: gh pr view --json files, gh pr review, gh pr comment, Read, Write
- Usage:
$github code-reviewer <review task>
- Best For: Code quality, security reviews, performance analysis
branch-manager
Branch management and workflow coordination
- Branch Strategy: GitFlow
- Merge Strategy: Intelligent
- Conflict Prevention: Proactive
- Tools: gh api (for branch operations), git commands, Bash
- Usage:
$github branch-manager <branch management task>
- Best For: Branch coordination, merge strategies, workflow management
Integration Commands
sync-coordinator
Multi-package synchronization
- Package Sync: Intelligent
- Version Alignment: Automatic
- Dependency Resolution: Advanced
- Tools: git commands, gh pr create, Read, Write, Bash
- Usage:
$github sync-coordinator <sync task>
- Best For: Package synchronization, version management, dependency updates
ci-orchestrator
CI/CD pipeline coordination
- Pipeline Management: Advanced
- Test Coordination: Parallel
- Deployment: Automated
- Tools: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
- Usage:
$github ci-orchestrator <CI/CD task>
- Best For: CI/CD coordination, test management, deployment automation
security-guardian
Security and compliance management
- Security Scan: Automated
- Compliance Check: Continuous
- Vulnerability Management: Proactive
- Tools: gh search code, gh issue create, gh secret list, Read, Write
- Usage:
$github security-guardian <security task>
- Best For: Security audits, compliance checks, vulnerability management
Usage Examples
Creating a coordinated pull request workflow:
$github pr-manager "Review and merge feature$new-integration branch with automated testing and multi-reviewer coordination"
Managing repository synchronization:
$github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
Setting up automated issue tracking:
$github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
Batch Operations
All GitHub modes support batch operations for maximum efficiency:
Parallel GitHub Operations Example:
[Single Message with BatchTool]:
Bash("gh issue create --title 'Feature A' --body '...'")
Bash("gh issue create --title 'Feature B' --body '...'")
Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
TodoWrite { todos: [todo1, todo2, todo3] }
Bash("git checkout main && git pull")
Integration with ruv-swarm
All GitHub modes can be enhanced with ruv-swarm coordination:
// Initialize swarm for GitHub workflow
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
mcp__claude-flow__agent_spawn { agentType: "coordinator", name: "GitHub Coordinator" }
mcp__claude-flow__agent_spawn { agentType: "reviewer", name: "Code Reviewer" }
mcp__claude-flow__agent_spawn { agentType: "tester", name: "QA Agent" }
// Execute GitHub workflow with coordination
mcp__claude-flow__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
1---2name: agent-github-modes3description: Agent skill for github-modes - invoke with $agent-github-modes4metadata:5 source: https://skillmd.com/skills/ruvnet/agent-github-modes6---78---9name: github-modes10description: Comprehensive GitHub integration modes for workflow orchestration, PR management, and repository coordination with batch optimization11tools: mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, Bash, TodoWrite, Read, Write12color: purple13type: development14capabilities:15 - GitHub workflow orchestration16 - Pull request management and review17 - Issue tracking and coordination18 - Release management and deployment19 - Repository architecture and organization20 - CI/CD pipeline coordination21priority: medium22hooks:23 pre: |24 echo "Starting github-modes..."25 echo "Initializing GitHub workflow coordination"26 gh auth status || (echo "GitHub CLI authentication required" && exit 1)27 git status > $dev$null || (echo "Not in a git repository" && exit 1)28 post: |29 echo "Completed github-modes"30 echo "GitHub operations synchronized"31 echo "Workflow coordination finalized"32---3334# GitHub Integration Modes3536## Overview37This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.3839## GitHub Workflow Modes4041### gh-coordinator42**GitHub workflow orchestration and coordination**43- **Coordination Mode**: Hierarchical44- **Max Parallel Operations**: 1045- **Batch Optimized**: Yes46- **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash47- **Usage**: `$github gh-coordinator <GitHub workflow description>`48- **Best For**: Complex GitHub workflows, multi-repo coordination4950### pr-manager51**Pull request management and review coordination**52- **Review Mode**: Automated53- **Multi-reviewer**: Yes54- **Conflict Resolution**: Intelligent55- **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task56- **Usage**: `$github pr-manager <PR management task>`57- **Best For**: PR reviews, merge coordination, conflict resolution5859### issue-tracker60**Issue management and project coordination**61- **Issue Workflow**: Automated62- **Label Management**: Smart63- **Progress Tracking**: Real-time64- **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite65- **Usage**: `$github issue-tracker <issue management task>`66- **Best For**: Project management, issue coordination, progress tracking6768### release-manager69**Release coordination and deployment**70- **Release Pipeline**: Automated71- **Versioning**: Semantic72- **Deployment**: Multi-stage73- **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite74- **Usage**: `$github release-manager <release task>`75- **Best For**: Release management, version coordination, deployment pipelines7677## Repository Management Modes7879### repo-architect80**Repository structure and organization**81- **Structure Optimization**: Yes82- **Multi-repo**: Support83- **Template Management**: Advanced84- **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash85- **Usage**: `$github repo-architect <repository management task>`86- **Best For**: Repository setup, structure optimization, multi-repo management8788### code-reviewer89**Automated code review and quality assurance**90- **Review Quality**: Deep91- **Security Analysis**: Yes92- **Performance Check**: Automated93- **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write94- **Usage**: `$github code-reviewer <review task>`95- **Best For**: Code quality, security reviews, performance analysis9697### branch-manager98**Branch management and workflow coordination**99- **Branch Strategy**: GitFlow100- **Merge Strategy**: Intelligent101- **Conflict Prevention**: Proactive102- **Tools**: gh api (for branch operations), git commands, Bash103- **Usage**: `$github branch-manager <branch management task>`104- **Best For**: Branch coordination, merge strategies, workflow management105106## Integration Commands107108### sync-coordinator109**Multi-package synchronization**110- **Package Sync**: Intelligent111- **Version Alignment**: Automatic112- **Dependency Resolution**: Advanced113- **Tools**: git commands, gh pr create, Read, Write, Bash114- **Usage**: `$github sync-coordinator <sync task>`115- **Best For**: Package synchronization, version management, dependency updates116117### ci-orchestrator118**CI/CD pipeline coordination**119- **Pipeline Management**: Advanced120- **Test Coordination**: Parallel121- **Deployment**: Automated122- **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task123- **Usage**: `$github ci-orchestrator <CI/CD task>`124- **Best For**: CI/CD coordination, test management, deployment automation125126### security-guardian127**Security and compliance management**128- **Security Scan**: Automated129- **Compliance Check**: Continuous130- **Vulnerability Management**: Proactive131- **Tools**: gh search code, gh issue create, gh secret list, Read, Write132- **Usage**: `$github security-guardian <security task>`133- **Best For**: Security audits, compliance checks, vulnerability management134135## Usage Examples136137### Creating a coordinated pull request workflow:138```bash139$github pr-manager "Review and merge feature$new-integration branch with automated testing and multi-reviewer coordination"140```141142### Managing repository synchronization:143```bash144$github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"145```146147### Setting up automated issue tracking:148```bash149$github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"150```151152## Batch Operations153154All GitHub modes support batch operations for maximum efficiency:155156### Parallel GitHub Operations Example:157```javascript158[Single Message with BatchTool]:159 Bash("gh issue create --title 'Feature A' --body '...'")160 Bash("gh issue create --title 'Feature B' --body '...'")161 Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")162 Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")163 TodoWrite { todos: [todo1, todo2, todo3] }164 Bash("git checkout main && git pull")165```166167## Integration with ruv-swarm168169All GitHub modes can be enhanced with ruv-swarm coordination:170171```javascript172// Initialize swarm for GitHub workflow173mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }174mcp__claude-flow__agent_spawn { agentType: "coordinator", name: "GitHub Coordinator" }175mcp__claude-flow__agent_spawn { agentType: "reviewer", name: "Code Reviewer" }176mcp__claude-flow__agent_spawn { agentType: "tester", name: "QA Agent" }177178// Execute GitHub workflow with coordination179mcp__claude-flow__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }180```