gh-projects

Automates GitHub Project V2 board management by adding issues and updating fields.

23|7|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/kinncj/MAPLE --skill gh-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-projects
Source: https://github.com/kinncj/MAPLE/tree/main/template/.opencode/skills/gh-projects
Command: npx skills add https://github.com/kinncj/MAPLE --skill gh-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplifies and automates the management of GitHub Projects v2 boards by transforming issues into board items, updating project fields, and querying the board to monitor progress.

Core Features & Use Cases

  • Add issues to a Project V2 board, creating items on the board to reflect new work.
  • Update single-select fields (Status, Type, ADR Required) and text fields for Epic/Owner data.
  • Query and report on board state to track progress across multiple issues.
  • Use in workflows to keep project boards synchronized with the repository’s issue lifecycle.

Quick Start

Provide a project number and issue details, then run the skill to add the issue to the board and initialize its fields.

Frequently Asked Questions about gh-projects

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

FAQPage Schema
How do I automate adding issues to GitHub Projects v2 boards?

Automate GitHub Projects v2 management by adding issues as board items and updating their fields. This skill transforms issues into board items and initializes project fields to reflect new work automatically.

Can I update single-select fields like Status and Type in GitHub Projects v2 using gh api?

Yes, you can update single-select fields like Status, Type, and ADR Required in GitHub Projects v2. The skill uses gh api GraphQL access to modify project board field values across issues.

Do I need the gh project CLI to manage GitHub Project v2 boards?

You need either the gh project CLI or gh api GraphQL access to manage GitHub Project v2 boards. The skill requires one of these tools to add items and update fields like Status and Owner data.

What's the best way to keep a GitHub project board synchronized with issue lifecycle changes?

Keep project boards synchronized with your issue lifecycle by using automation to add issues to the board and update text fields for Epic or Owner data. This ensures board state reflects repository progress.

How does querying GitHub Projects v2 board state help track issue progress?

Querying GitHub Projects v2 board state reports on field values and item statuses across multiple issues. This allows you to monitor progress and track ownership data directly from your project board.

Can I update text fields for Epic and Owner data in GitHub Projects v2?

Yes, you can update text fields for Epic and Owner data in GitHub Projects v2. The skill supports updating these text fields alongside single-select fields when managing board items.