GitHub Integration Modes Skill

Overview

This skill provides comprehensive GitHub integration modes for workflow orchestration, PR management, issue tracking, and repository coordination. Each mode is optimized for specific GitHub workflows with batch operation support.

Key Capabilities:

• GitHub workflow orchestration and coordination
• Pull request management and review automation
• Issue tracking and project management
• Release coordination and deployment
• Repository architecture and organization
• CI/CD pipeline coordination

Quick Start

# Verify GitHub CLI authentication
gh auth status

# Check repository access
gh repo view

# List open PRs
gh pr list

# List issues
gh issue list

# Check workflow runs
gh run list --limit 5

GitHub Workflow Modes

1. gh-coordinator

GitHub workflow orchestration and coordination

# Coordinate multiple GitHub operations
gh issue create --title "Feature: New Integration" --body "Description here"
gh pr create --title "Implement feature" --body "Closes #123"
gh workflow run ci.yml

• Coordination Mode: Hierarchical
• Max Parallel Operations: 10
• Best For: Complex GitHub workflows, multi-repo coordination

2. pr-manager

Pull request management and review coordination

# Create PR with reviewers
gh pr create \
  --title "Feature implementation" \
  --body "## Summary\n- Feature 1\n- Feature 2" \
  --reviewer user1,user2 \
  --assignee @me

# Review PR
gh pr review 123 --approve --body "LGTM!"

# Merge with squash
gh pr merge 123 --squash --delete-branch

• Review Mode: Automated
• Multi-reviewer: Yes
• Best For: PR reviews, merge coordination, conflict resolution

3. issue-tracker

Issue management and project coordination

# Create structured issue
gh issue create \
  --title "Bug: Login failure" \
  --body "## Description\n...\n## Steps to Reproduce\n1. ..." \
  --label "bug,priority:high" \
  --assignee @me \
  --milestone "v2.0"

# Update issue
gh issue edit 123 --add-label "in-progress"

# Close with comment
gh issue close 123 --comment "Fixed in #456"

• Issue Workflow: Automated
• Label Management: Smart
• Best For: Project management, issue coordination, progress tracking

4. release-manager

Release coordination and deployment

# Create release
gh release create v1.2.0 \
  --title "Release v1.2.0" \
  --notes "## What's New\n- Feature 1\n- Bug fix 2" \
  --target main

# Upload release assets
gh release upload v1.2.0 ./dist/*.zip

# List releases
gh release list

• Release Pipeline: Automated
• Versioning: Semantic
• Best For: Release management, version coordination, deployment pipelines

Repository Management Modes

5. repo-architect

Repository structure and organization

# Create repository
gh repo create my-project --public --description "Project description"

# Clone with specific options
gh repo clone owner/repo -- --depth=1

# Fork repository
gh repo fork owner/repo --clone

# Set repository settings
gh repo edit --enable-issues --enable-wiki=false

• Structure Optimization: Yes
• Multi-repo: Support
• Best For: Repository setup, structure optimization, multi-repo management

6. code-reviewer

Automated code review and quality assurance

# Get PR diff
gh pr diff 123

# Get changed files
gh pr view 123 --json files --jq '.files[].path'

# Add review comment
gh pr review 123 --comment --body "Consider refactoring this function"

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

• Review Quality: Deep
• Security Analysis: Yes
• Best For: Code quality, security reviews, performance analysis

7. branch-manager

Branch management and workflow coordination

# Create feature branch via API
gh api repos/:owner/:repo/git/refs \
  -f ref='refs/heads/feature/new-feature' \
  -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')

# Delete branch
gh api repos/:owner/:repo/git/refs/heads/old-branch --method DELETE

# List branches
gh api repos/:owner/:repo/branches --jq '.[].name'

• Branch Strategy: GitFlow
• Merge Strategy: Intelligent
• Best For: Branch coordination, merge strategies, workflow management

Integration Modes

8. sync-coordinator

Multi-package synchronization

# Sync files across repos
gh api repos/:owner/:repo/contents/file.md --jq '.content' | base64 -d

# Create sync PR
gh pr create \
  --title "Sync: Update shared configurations" \
  --head sync/config-update \
  --base main

9. ci-orchestrator

CI/CD pipeline coordination

# Trigger workflow
gh workflow run ci.yml --ref main

# Check workflow status
gh run list --workflow=ci.yml --limit=5

# View run details
gh run view $RUN_ID

# Download artifacts
gh run download $RUN_ID

10. security-guardian

Security and compliance management

# List secret scanning alerts
gh api repos/:owner/:repo/secret-scanning/alerts

# List code scanning alerts
gh api repos/:owner/:repo/code-scanning/alerts

# Check Dependabot alerts
gh api repos/:owner/:repo/dependabot/alerts

Batch Operations

All GitHub modes support batch operations for maximum efficiency:

# Parallel issue creation
gh issue create --title "Task 1" --body "..." &
gh issue create --title "Task 2" --body "..." &
gh issue create --title "Task 3" --body "..." &
wait

# Batch label management
for issue in 1 2 3 4 5; do
  gh issue edit $issue --add-label "sprint-24" &
done
wait

# Parallel PR reviews
for pr in 10 11 12; do
  gh pr review $pr --approve --body "Automated approval" &
done
wait

MCP Tool Integration

Swarm Coordination

// Initialize GitHub workflow swarm
mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }

// Execute workflow with coordination
mcp__claude-flow__task_orchestrate {
  task: "GitHub workflow coordination",
  strategy: "parallel",
  priority: "high"
}

// Store workflow state
mcp__claude-flow__memory_usage {
  action: "store",
  key: "github/workflow/state",
  value: {
    mode: "pr-manager",
    activePRs: [123, 124, 125],
    status: "reviewing"
  }
}

GitHub-Specific Tools

// Repository analysis
mcp__claude-flow__github_repo_analyze {
  repo: "owner/repo",
  analysis_type: "code_quality"
}

// PR management
mcp__claude-flow__github_pr_manage {
  repo: "owner/repo",
  action: "review",
  pr_number: 123
}

// Issue tracking
mcp__claude-flow__github_issue_track {
  repo: "owner/repo",
  action: "triage"
}

Usage Examples

Complete PR Workflow

# 1. Create feature branch
git checkout -b feature/new-feature

# 2. Make changes and commit
git add .
git commit -m "feat: Add new feature"
git push -u origin feature/new-feature

# 3. Create PR with full metadata
gh pr create \
  --title "feat: Add new feature" \
  --body "## Summary
- Implements feature X
- Adds tests for Y

## Testing
- [x] Unit tests pass
- [x] Integration tests pass

Closes #123" \
  --reviewer tech-lead,senior-dev \
  --assignee @me \
  --label "enhancement,needs-review" \
  --milestone "v2.0"

# 4. Wait for reviews and CI
gh pr checks 456 --watch

# 5. Merge when ready
gh pr merge 456 --squash --delete-branch

Automated Issue Management

# Triage unlabeled issues
gh issue list --label "" --json number,title | \
  jq -r '.[] | "\(.number): \(.title)"'

# Bulk close stale issues
gh issue list --label "stale" --json number | \
  jq -r '.[].number' | while read num; do
    gh issue close $num --comment "Closing stale issue"
  done

# Create linked issues
PARENT=$(gh issue create --title "Epic: Feature Set" --body "Parent issue")
gh issue create --title "Sub-task 1" --body "Part of #$PARENT"
gh issue create --title "Sub-task 2" --body "Part of #$PARENT"

Best Practices

1. Authentication

• Use

  gh auth login

  for initial setup
• Store tokens securely in GitHub Secrets
• Use GITHUB_TOKEN in workflows
• Rotate tokens regularly

2. Rate Limiting

• Batch operations when possible
• Use GraphQL for complex queries
• Implement exponential backoff
• Cache API responses

3. Workflow Design

• Use reusable workflows
• Implement proper error handling
• Add meaningful commit messages
• Follow semantic versioning

4. Security

• Enable branch protection
• Require PR reviews
• Use signed commits
• Enable security scanning

Configuration Options

Mode	Max Parallel	Batch Optimized	Primary Use
gh-coordinator	10	Yes	Complex workflows
pr-manager	5	Yes	PR reviews
issue-tracker	20	Yes	Issue management
release-manager	3	No	Releases
repo-architect	5	Yes	Repo setup
code-reviewer	5	Yes	Code review
branch-manager	10	Yes	Branch ops

Related Skills

• github-sync - Repository synchronization
• github-workflow - CI/CD automation
• github-swarm-pr - PR swarm management
• github-swarm-issue - Issue swarm coordination
• github-project-board - Project board sync

---

Version History

• 1.0.0 (2026-01-02): Initial skill conversion from github-modes agent