gh-project-sync

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

Updated Aug 23, 2026

Search Tags:#automation #GraphQL #epic #project-management #gh-cli #github-projects #issues-sync

Ready to run

npx skills add https://github.com/wscffaa/claude-gh-skills --skill gh-project-sync

💬 Prompt for ChatGPT / Claude Chat▼

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.