legion:github-sync

Create GitHub issues, PRs, and milestones via the gh CLI.

72|8|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/9thLevelSoftware/legion --skill legion-github-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: legion:github-sync
Source: https://github.com/9thLevelSoftware/legion/tree/main/skills/github-sync
Command: npx skills add https://github.com/9thLevelSoftware/legion --skill legion-github-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Legion teams need reliable, auditable coordination of GitHub artifacts (issues, PRs, and milestones) across planning, building, and reviewing phases, with graceful degradation when GitHub is unavailable.

Core Features & Use Cases

  • Create and attach phase issues to ROADMAP milestones for traceability and progress tracking.
  • Automatically generate PRs after phase execution, referencing the phase issue when present.
  • Synchronize ROADMAP milestones with GitHub milestones, and provide live status readback for the dashboard.

Quick Start

Start Legion with GitHub integration enabled to create and track phase issues, PRs, and milestones automatically.

Frequently Asked Questions about legion:github-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub issue and pull request creation for workflow milestones?

You can automate GitHub issue and pull request creation by linking workflow phases to GitHub milestones. This integration generates phase issues and PRs automatically, referencing the phase issue to enforce traceability throughout planning, building, and reviewing.

What happens to GitHub workflow synchronization when the GitHub API is unavailable?

When GitHub is unavailable, the workflow synchronization degrades gracefully. It continues coordinating phase work locally without blocking execution, ensuring your workflow proceeds even if GitHub issues, PRs, or milestone updates cannot be synchronized.

Do I need the gh CLI installed and authenticated to sync GitHub milestones and issues?

Yes, you need the gh CLI installed, authenticated, and a GitHub remote configured. The integration validates these prerequisites before using the CLI to create issues, PRs, and milestones for live status readback.

How does linking roadmap milestones to GitHub issues improve project traceability?

Linking roadmap milestones to GitHub issues improves traceability by mapping phases to issues, PRs, and milestones using STATE.md linking tables. This provides live status readback for dashboards and connects planning directly to code review.

Can I map workflow phases to existing GitHub milestones for live status readback?

Yes, you can synchronize roadmap milestones with existing GitHub milestones. The integration maps phase work to issues and PRs, providing live status readback to coordinate planning, building, and reviewing phases.

Best way to coordinate GitHub pull requests with phase issues during code review?

The best way to coordinate GitHub pull requests with phase issues is to automatically generate PRs after phase execution. The PR references the phase issue when present, enforcing traceability and linking milestone synchronization to code review.