emasoft/amia-github-integration

GitHub Integration Dispatcher

Overview

Routes GitHub integration tasks to specialized skills (PRs, Projects V2, Kanban, worktrees, API, multi-user, batch).

Prerequisites

• GitHub CLI 2.14+ authenticated (gh auth status)
• Write permissions on target repository
• Setup details: prerequisites-and-setup

Instructions

1. Confirm auth: gh auth status (CLI 2.14+ required).
2. Route by task type:
   • PRs --> amia-github-pr-workflow
   • Projects V2 --> amia-github-projects-sync
   • Kanban --> amia-kanban-orchestration
   • Worktrees --> amia-git-worktree-operations
   • API ops --> api-operations
   • Multi-user --> multi-user-workflow
3. Batch ops: preview first (gh issue list --label X --state open), then execute.
4. Verify result: gh issue view <N> or gh pr status.
5. On errors: see the detailed guide in Resources.

Checklist

Copy this checklist and track your progress:

• [ ] GitHub CLI 2.14+ installed
• [ ] gh auth status confirms authentication
• [ ] Task type identified (PR / Projects V2 / Kanban / Worktree / API / Multi-User / Batch)
• [ ] Routed to correct specialized skill or reference
• [ ] Batch ops: dry-run preview completed before execution
• [ ] Operation executed and result verified

Output

| Operation | Output | |-----------|--------| | Routing | Name of specialized skill to invoke | | Batch ops | Summary of affected items and changes applied | | Automation scripts | JSON/Markdown reports via --output-file | | Verification | gh CLI confirmation of current state |

Output discipline: All scripts support --output-file <path>. Use it in automated workflows to minimize token consumption.

Error Handling

Non-zero exit codes on failure; check stderr and the detailed guide in Resources.

Examples

Example: Bulk add label to open bug issues

# Preview affected issues
gh issue list --label "bug" --state open --json number,title \
  --jq '.[] | "\(.number): \(.title)"'

# Apply label
gh issue list --label "bug" --state open --json number \
  --jq '.[].number' | xargs -I {} gh issue edit {} --add-label "priority:critical"

# Verify
gh issue view 15 --json labels --jq '.labels[].name'

Skill Version: 2.0.0 | Last Updated: 2026-02-05

Resources

Full reference: detailed-guide:

• Decision Tree: Which Skill to Use?
  • Pull Requests
  • Projects V2 Sync
  • Kanban Board Operations
  • Git Worktrees
  • GitHub API Operations
  • Multiple GitHub Identities
• Batch Operations
  • Batch Label Operations
  • Automation Scripts
• Error Handling
• Extended Examples
  • Route to PR skill
  • Bulk add label to bug issues
  • Projects V2 sync
• First-Time Setup
• Changelog
• Reference Documents Index