skills.rest
semicolon-devteam
semicolon-devteamOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sync-project-status

Synchronize GitHub Projects statuses with Issue states via GraphQL mutations.

Updated Dec 11, 2025
Search Tags:#automation#project management#synchronization#GraphQL#GitHub Projects#SEMO#issue status
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill sync-project-status
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-project-status
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/pm/skills/sync-project-status
Command: npx skills add https://github.com/semicolon-devteam/semo --skill sync-project-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, gh.

What problem does it solve?

This Skill automatically synchronizes the status of GitHub Issues with their corresponding items in GitHub Projects, resolving discrepancies and ensuring that project boards accurately reflect the real-time state of tasks.

Core Features & Use Cases

  • Status Discrepancy Detection: Identifies when an Issue's state (e.g., open, closed) doesn't match its Projects board status.
  • Automated Status Update: Corrects inconsistent statuses in GitHub Projects to align with the Issue's actual state.
  • Dry Run Mode: Allows previewing proposed changes without applying them, ensuring control over updates.
  • Use Case: If a developer closes an issue but its status on the GitHub Projects board remains "In Progress", this skill can automatically detect and update the Projects status to "Done".

Quick Start

Sync all project statuses: "Projects 상태 동기화" Check for inconsistencies (dry run): "Projects 상태 동기화 --dry-run"

Frequently Asked Questions about sync-project-status

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

FAQPage Schema
How do I sync GitHub Issues status with GitHub Projects board?▼

Sync GitHub Issues status with GitHub Projects by running the Skill with your project number and sprint name. It detects mismatches between Issue states and Projects statuses, then updates the board via GraphQL mutations to match the Issue's current state.

Can I preview status changes before applying them to my GitHub Projects?▼

Yes, use dry-run mode to preview all proposed status updates without making changes. This validates discrepancies and shows exactly what will be corrected before you commit the synchronization.

What happens when an issue state doesn't match its GitHub Projects status?▼

Status discrepancies occur when an Issue's state (open, closed) diverges from its Projects board status. This Skill detects these inconsistencies and automatically corrects the Projects status to align with the Issue's actual state.

Do I need GitHub CLI to use this synchronization automation?▼

Yes, this Skill requires Bash and the GitHub CLI (gh) to query and update issue states and project statuses via GraphQL. Both dependencies must be installed and authenticated before running synchronization.

Can I sync statuses for a specific project and sprint?▼

Yes, you provide a project number and sprint name as inputs, allowing you to synchronize statuses for a specific project and sprint scope rather than syncing all projects at once.

What does the completion report show after syncing?▼

The Skill outputs a completion report detailing all detected discrepancies, applied updates, and final status mappings. The report confirms successful synchronization and documents which statuses were corrected.

Related Skills

Explore More Product & Management Skills→
semicolon-devteamsemicolon-devteam

sync-project-status

Synchronize GitHub Projects statuses with Issue states via GraphQL mutations.

Official
Intermediate
V4-CompanyV4-Company
2

marsai:gandalf-webhook

Route tasks to Gandalf via webhook for publish, notify, and ask actions.

Official
Advanced
rnbenrnben

linear

Manage Linear issues, projects, and teams via GraphQL with curl.

Community
Intermediate
anhhung04anhhung04
1

github-triage

Automate task creation and status updates from GitHub issues via the API.

Community
Basic