project-sync-issues

Synchronize GitHub Issue/PR statuses with project statuses via workflows.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Fandhe-AI/agent-cli-skills --skill project-sync-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-sync-issues
Source: https://github.com/Fandhe-AI/agent-cli-skills/tree/main/skills/project-sync-issues
Command: npx skills add https://github.com/Fandhe-AI/agent-cli-skills --skill project-sync-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the synchronization of Issue/PR status changes with project status in GitHub, ensuring project tracking remains accurate and up-to-date without manual updates.

Core Features & Use Cases

  • Automatic Sync: Keeps Issue/PR state changes automatically updated in the project's Status field using GitHub Actions.
  • Mode A (Recommended): Generates a .github/workflows/project-sync.yml file with the Fandhe-AI/actions/project-sync Composite Action to create workflows that synchronize statuses.
  • Mode B (One-Time Fix): Identifies and resolves inconsistencies between Issue/PR statuses and project statuses in a single execution.
  • Custom Status Mapping: Allows users to map issue or PR status changes to project status names for greater control over the workflow.

Quick Start

To automatically set up the sync workflow for a GitHub project, use the project-sync-issues skill by providing the project number and optional custom status names.

Frequently Asked Questions about project-sync-issues

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

FAQPage Schema
How do I automatically sync GitHub Issue and PR statuses with my project board?

To automatically sync GitHub Issue and PR statuses, you can generate a GitHub Actions workflow file using a composite action. This automatically updates the project Status field whenever an Issue or PR state changes, ensuring consistent tracking without manual updates.

What's the best way to fix inconsistent project board statuses for issues and pull requests in GitHub?

Fixing inconsistent GitHub project board statuses requires a one-time correction tool that identifies discrepancies between current Issue/PR states and project statuses. Running this tool resolves mismatches in a single execution, bringing your project tracking back to an accurate state.

Can I map custom status names when synchronizing GitHub Issues to project boards?

Yes, you can map custom status names when synchronizing GitHub Issues to project boards. The workflow allows you to map issue or PR status changes to specific project status names, giving you greater control over how state transitions are reflected on your project board.

Do I need a Personal Access Token or GitHub App to automate project status synchronization?

Yes, you need either a Personal Access Token or a GitHub App to authenticate project status synchronization. GitHub authentication is required to authorize the automated actions that update and correct Issue and PR statuses within your project tracking.

How does GitHub Actions workflow handle Issue and PR state changes for project tracking?

GitHub Actions handles Issue and PR state changes for project tracking by using a generated workflow file with a composite action. This action listens for state changes and automatically updates the corresponding project Status field, keeping project tracking accurate and up-to-date.

When should I use a one-time correction tool instead of an automatic sync workflow for GitHub projects?

Use a one-time correction tool when you need to resolve existing inconsistencies between Issue/PR statuses and project statuses in a single execution. Set up the automatic sync workflow for ongoing state changes to prevent future mismatches from occurring.