---

name: github-integration description: GitHub API integration for issues, pull requests, workflows, and repository management. Use when working with GitHub issues, PRs, releases, or CI/CD workflows. allowed-tools: Bash, Read, Write, WebFetch mcp_tools:

• "github_list_issues"
• "github_get_issue"
• "github_create_issue"
• "github_update_issue"
• "github_add_comment"
• "github_list_pulls"
• "github_get_pull"
• "github_create_pull"
• "github_merge_pull"
• "github_list_labels"
• "github_add_labels"
• "github_list_milestones"
• "github_list_workflows"
• "github_list_workflow_runs"
• "github_get_repo"
• "github_list_releases"
• "github_list_branches"
• "github_compare_commits"
• "github_list_pr_reviews"
• "github_create_pr_review"
• "github_search_code"

---

GitHub Integration Skill

Version: 1.0.0 Purpose: GitHub API operations for repository collaboration

---

Triggers

---

Prerequisites

Copy# Required environment variable
export GITHUB_TOKEN="ghp_..."

# Optional defaults
export GITHUB_DEFAULT_OWNER="owner"
export GITHUB_DEFAULT_REPO="repo"

---

Integrated MCP Tools

---

Workflow: Issue Management

Step 1: List Issues

CopyUse github_list_issues with:
- state: "open" | "closed" | "all"
- per_page: 30 (max 100)

Step 2: Create Issue

CopyUse github_create_issue with:
- title: Clear, descriptive title
- body: Markdown description
- labels: ["bug", "enhancement"]

Step 3: Update Issue

CopyUse github_update_issue with:
- issue_number: Issue ID
- state: "open" | "closed"
- labels: Updated labels

---

Workflow: Pull Request

Step 1: Create PR

CopyUse github_create_pull with:
- title: PR title
- body: Description with context
- head: Source branch
- base: Target branch (main)

Step 2: Review PR

CopyUse github_create_pr_review with:
- pull_number: PR ID
- event: "APPROVE" | "REQUEST_CHANGES" | "COMMENT"
- body: Review comments

Step 3: Merge PR

CopyUse github_merge_pull with:
- pull_number: PR ID
- merge_method: "merge" | "squash" | "rebase"

---

Workflow: CI/CD Monitoring

Step 1: List Workflows

CopyUse github_list_workflows to see all CI configurations

Step 2: Check Runs

CopyUse github_list_workflow_runs with:
- workflow_id: Specific workflow
- status: "completed" | "in_progress" | "queued"

---

Best Practices

✅ GOOD:

• Use descriptive issue/PR titles
• Include context in descriptions
• Label issues appropriately
• Review before merging

❌ BAD:

• Vague titles like "Fix bug"
• Empty PR descriptions
• Merging without review
• Ignoring CI failures

---

Checklist

• GITHUB_TOKEN configured
• Owner/repo specified
• Issue/PR has clear title
• Labels applied
• CI checks passed