status-workflow

Moves issues between Project Status options and verifies via GraphQL.

18|4|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/botminter/botminter --skill status-workflow
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: status-workflow
Source: https://github.com/botminter/botminter/tree/main/.agents/planning/2026-03-22-console-web-ui/fixture-gen/fixtures/team-repo/coding-agent/skills/status-workflow
Command: npx skills add https://github.com/botminter/botminter --skill status-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

Keeps GitHub Projects v2 items in sync by automating Status field transitions and related issue annotations so teams don't manage status changes manually across boards and repos.

Core Features & Use Cases

  • Status Field Mutations: Resolve project item and option IDs and set the single-select Status field for an issue.
  • Verification: Confirm changes with GraphQL queries to detect silent failures or permission issues.
  • Attribution & Labels: Post role/emoji attribution comments and optionally add or remove labels as part of workflow transitions.
  • Use Case: Automatically move an issue from "Backlog" to "In Progress", verify the change, add a "role/dev" label, and record who performed the transition.

Quick Start

Run the status-workflow to set an issue's project Status to the target option using the repo's board-scanner environment variables.

Frequently Asked Questions about status-workflow

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

FAQPage Schema
How do I automate GitHub Projects v2 status transitions for issues?โ–ผ

Automate GitHub Projects v2 status transitions by resolving project item and option IDs to set the single-select Status field for an issue. This workflow uses GraphQL queries to verify updates and detect silent failures or permission issues during automation.

Can I add or remove labels when moving an issue between Status field options?โ–ผ

Yes, you can add or remove labels when moving an issue between Status field options. The workflow performs status field mutations and optionally manages issue annotations alongside the transition to keep project boards synchronized.

Do I need the gh CLI and jq to update project board statuses?โ–ผ

Yes, you need the gh CLI and jq to update project board statuses. A valid GH_TOKEN and board-scanner variables like PROJECT_ID, STATUS_FIELD_ID, and FIELD_DATA are also required to execute the GraphQL queries for verification.

What is the best way to verify GitHub Projects v2 status updates and prevent silent failures?โ–ผ

The best way to verify GitHub Projects v2 status updates is by confirming changes with GraphQL queries. This verification mechanism detects silent failures or permission issues immediately after applying status field mutations to project items.

How do I record attribution comments on team project boards during workflow automation?โ–ผ

Record attribution comments on team project boards by posting role or emoji annotations during workflow automation. This tracks who performed the status transition while automatically moving issues across project board columns.

Why are my GitHub Projects v2 status field mutations not updating issue items?โ–ผ

GitHub Projects v2 status field mutations may fail due to silent failures or permission issues. Resolve project item and option IDs correctly, ensure a valid GH_TOKEN is set, and use GraphQL queries to verify that updates are applied successfully.