gh-project-sync

Automates GitHub Issue syncing to GitHub Projects via gh CLI and GraphQL API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/wscffaa/claude-gh-skills --skill gh-project-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-project-sync
Source: https://github.com/wscffaa/claude-gh-skills/tree/main/gh-project-sync
Command: npx skills add https://github.com/wscffaa/claude-gh-skills --skill gh-project-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates syncing GitHub Issues into GitHub Projects to streamline project tracking and visibility.

Core Features & Use Cases

  • Interactive project selection: choose a target project and scope for syncing.
  • Bulk import of issues: map a range or specific set of issues into a project.
  • Epic support: auto-include sub-issues of an Epic to the same project and apply status based on labels.
  • Status mapping: translate issue priority labels into project status columns.

Quick Start

  • List available projects: python3 scripts/list_projects.py --json
  • Sync a range of issues into a project: python3 scripts/sync_project.py --project 1 --issues "63-71"
  • Or sync all open issues: python3 scripts/sync_project.py --project 1 --all

Frequently Asked Questions about gh-project-sync

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

FAQPage Schema
How do I sync GitHub Issues into GitHub Projects automatically?

To sync GitHub Issues into GitHub Projects, you can use a script that leverages the gh CLI and GraphQL API to batch-add specific issues or ranges to a selected project board while preserving metadata and links.

Can I bulk import open issues into a GitHub Project board?

Yes, you can bulk import open issues into a GitHub Project board by running a sync command that targets a specific project and automatically adds all open issues or a defined range to it.

Does syncing GitHub Epics to a project also include sub-issues?

Yes, syncing GitHub Epics to a project auto-includes their sub-issues to the same project board and applies status mappings based on existing priority labels.

How do I map issue labels to project board status columns?

You can map issue labels to project status columns during the synchronization process; the tool translates existing issue priority labels into the corresponding status columns on your GitHub Project.

What is the best way to manage release planning with GitHub Issues and Projects?

The best way to manage release planning is to automate issue tracking by syncing GitHub Issues into Projects, which streamlines visibility and collaboration across your software development workflow.

Do I need the gh CLI to add issues to a GitHub Project?

Yes, you need the gh CLI installed because the synchronization relies on it alongside the GitHub GraphQL API to interact with your repository and configure the project board.