skills.rest
sarkarshivaditya-lab
sarkarshivaditya-labCOMMUNITY
Explore all skills by this author →
GitHub

project-status-sync

Synchronizes GitHub Project fields with actual work state using gh CLI commands.

Updated Jan 1, 2026
Search Tags:#automation#project management#verification#issue tracking#gh cli#status sync#github projects
One-click install
npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill project-status-sync-sarkarshivaditya-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-status-sync
Source: https://github.com/sarkarshivaditya-lab/WellMate/tree/main/.engineering-skills/troykelly-claude-skills/skills/project-status-sync
Command: npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill project-status-sync-sarkarshivaditya-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GitHub Project boards drift out of sync with real work progress, forcing teams to manually update status, verification, and criteria fields after every change. This Skill keeps project fields accurate by updating them programmatically as work state changes. ## Core Features & Use Cases - Status Transitions: Move issues through Backlog, Ready, In Progress, In Review, Done, and Blocked states following a defined transition model. - Verification Field Updates: Set Verification status, Criteria Met counts, Last Verified dates, and Verified By values after verification runs. - Batch Updates: Update multiple project fields in one pass after verification completes, and add new issues to projects with initial field values. - Use Case: After an acceptance criteria verification passes, automatically set the issue's Verification field to Passing, increment Criteria Met, stamp the Last Verified date, and move Status to In Review. ## Quick Start Ask the agent to update the GitHub Project status of issue 42 to In Progress and mark its verification as Passing.

Frequently Asked Questions about project-status-sync

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

FAQPage Schema
How do I update a GitHub Project field from the command line?▼

Use gh project item-edit with the project ID, item ID, and field ID. First retrieve field IDs with gh project field-list and the item ID with gh project item-list, then pass the appropriate value flag such as --single-select-option-id, --number, --date, or --text.

How do I find the field ID and item ID for a GitHub Project?▼

Run gh project field-list with your project number to get field IDs and option IDs, and gh project item-list to find the item ID matching your issue number. Both commands support --format json for filtering with jq.

What environment setup does GitHub Project synchronization require?▼

The GITHUB_PROJECT environment variable must be set to the project URL, such as https://github.com/users/troykelly/projects/4. You also need the gh CLI authenticated with scopes that permit project item editing.

Why does updating a GitHub Project field fail with permission denied?▼

Permission denied errors mean the gh authentication token lacks the required project scopes. Re-authenticate with gh auth and ensure the token includes project read and write permissions for the target project.

What happens if an issue is not in the GitHub Project yet?▼

Field updates fail when the issue has no project item. Add it first with gh project item-add using the issue URL, then set initial field values such as Status, Priority, Type, Criteria Total, and Verification.

Related Skills

Explore More Software Engineering Skills→
semicolon-devteamsemicolon-devteam

set-project-field

Automate GitHub Project field configuration for issues using GraphQL mutations.

Official
Advanced
bryan-thompsoncodesbryan-thompsoncodes

workday-sprint

Categorize GitHub Project V2 sprint items by Status for Bryan.

Community
Intermediate
eusouwillnuneseusouwillnunes

qa

Validate agent-produced checklists against predefined QA criteria with pass/fail results.

Community
Intermediate
ascerra-fullsend-rehearsalascerra-fullsend-rehearsal

merge-queue

Manage GitHub merge queues by enqueuing pull requests and checking status via GraphQL API.

Official
Intermediate