skills.rest
fx
fxCOMMUNITY
Explore all skills by this author →
GitHub

issue-updater

Updates GitHub issues with implementation plans, status changes, and progress comments via the gh CLI.

Updated Nov 2, 2025
Search Tags:#workflow automation#github#issue tracking#status updates#gh cli#labels#project board
One-click install
npx skills add https://github.com/fx/skills --skill issue-updater-fx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-updater
Source: https://github.com/fx/skills/tree/main/skills/issue-updater
Command: npx skills add https://github.com/fx/skills --skill issue-updater-fx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping GitHub issues synchronized with actual development work is tedious and often skipped, leaving stakeholders without visibility into planning, progress, and completion status. ## Core Features & Use Cases - Plan Documentation: Posts implementation plans as issue comments and applies a 'planned' label, skipping duplicates when a plan already exists. - Status Tracking: Updates project board fields (Todo, In Progress, Done) and posts milestone comments linking branches, commits, and pull requests. - Label & Board Management: Creates missing labels, synchronizes issue labels with project board status, and handles permission or rate-limit errors gracefully. - Use Case: During an automated SDLC workflow, after a plan is approved, the skill comments the plan on issue #42, adds the 'planned' label, moves the project card to In Progress, and later links the created PR. ## Quick Start Update GitHub issue 42 with this implementation plan and move its project board status to In Progress.

Frequently Asked Questions about issue-updater

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

FAQPage Schema
How do I add an implementation plan to a GitHub issue automatically?▼

Post the plan as an issue comment using gh issue comment, then apply a 'planned' label with gh issue edit. The skill first checks for an existing 'planned' label to avoid posting duplicate plans.

How to update GitHub project board status from the command line?▼

Use gh project item-edit with the item ID, status field ID, project ID, and the target single-select option ID. You can discover these IDs with gh project field-list and gh project item-list.

What happens if the 'planned' label does not exist in the repository?▼

The skill creates the missing label using gh label create with a description and color before applying it to the issue. The same approach applies to other required labels like 'in-progress' or 'pr-ready'.

Can this skill work without a GitHub project board?▼

Yes. When no project board is available, it continues with issue-only updates such as comments and labels, and reports the limitation rather than failing.

How does the skill avoid duplicate plan comments on an issue?▼

It checks the issue's labels with gh issue view and skips adding a new plan if the 'planned' label is already present, preventing redundant planning comments.

Related Skills

Explore More Software Engineering Skills→
BamoseBamose
5

planner

Translate requirements into structured implementation roadmaps with dependencies and testing strategies.

Community
Advanced
devbasexdevbasex
1

merged

Delete merged branches and worktrees with approval, then update the base branch.

Official
Advanced
oElberteoElberte

follow-up-on-pr

Rebase pull requests, resolve reviewer feedback, and fix CI failures.

Community
Intermediate
automatedigitalautomatedigital
1

tasker

Automate ticket lifecycle from ideation to merged pull request across ticket trackers and GitHub.

Official
Advanced