eia-github-integration

name	eia-github-integration
description	Use when integrating GitHub Projects. Trigger with GitHub sync, label setup, or PR workflow requests.
license	Apache-2.0
compatibility	Requires GitHub CLI version 2.14 or higher, GitHub account with write permissions to target repositories, and basic Git knowledge. Requires AI Maestro installed.
metadata	{"author":"Emasoft","version":"1.0.0"}
agent	api-coordinator
context	fork
workflow-instruction	support
procedure	support-skill
user-invocable	false

GitHub Integration Dispatcher

Overview

This skill is the entry point for all GitHub integration tasks in agent orchestration workflows. It routes you to specialized skills based on your task type. Use this skill to determine which specialized GitHub skill to invoke.

Prerequisites

Before using any GitHub integration skill, ensure:

1. GitHub CLI version 2.14 or higher is installed (gh --version)
2. GitHub CLI is authenticated (gh auth status)
3. You have write permissions to the target repository
4. Basic familiarity with Git commands

First-time setup:

# Install GitHub CLI
brew install gh   # macOS
# or see https://cli.github.com/manual/installation for other platforms

# Authenticate
gh auth login

# Verify authentication
gh auth status

For detailed setup instructions, see references/prerequisites-and-setup.md.

Decision Tree: Which Skill to Use?

Use this decision tree to route to the appropriate specialized skill:

I need to work with Pull Requests

→ Use eia-github-pr-workflow

This skill covers:

• Creating pull requests linked to issues
• PR status monitoring and CI/CD integration
• Merge strategies (squash, merge commit, rebase)
• Auto-merge configuration
• PR workflow automation

I need to sync with GitHub Projects V2

→ Use eia-github-projects-sync

This skill covers:

• Bidirectional synchronization between agent tasks and GitHub Projects V2
• Creating and configuring project boards
• Status column management (Backlog, Todo, In Progress, AI Review, Human Review, Merge/Release, Done, Blocked)
• Custom field configuration (Priority, Due Date, Effort)
• Automation rules (auto-add, auto-archive, status transitions)
• Conflict resolution and sync health monitoring

I need to orchestrate Kanban board operations

→ Use eia-kanban-orchestration