gh

Manage GitHub Projects v2 boards and issue workflows via gh CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Keeps GitHub Projects v2 boards and issue workflows consistent, auditable, and easy to operate by wrapping the gh CLI with validated operations, GraphQL verification, and role-attributed comments so agents and teams don't need to run manual commands or parse raw CLI output.

Core Features & Use Cases

  • Board view: fetches project items, groups issues by Status field, and displays epic-to-story relationships for quick overviews.
  • Issue creation: create epics or stories, add parent links, set initial status, and add items to the project with validation.
  • Status transitions: update single-select Status with option ID resolution and GraphQL verification to prevent silent failures.
  • Comments, assignment, milestones, PR operations, and flexible querying for common project-management workflows with robust error handling and auto-recovery for missing items.
  • Use case: a product manager can ask the agent to create an epic, add stories, transition statuses through human gates, and document each step with attribution comments.

Quick Start

Ask the assistant to "Show the project board and group issues by status for the team repository."

Frequently Asked Questions about gh

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

FAQPage Schema
How do I automate GitHub Projects v2 issue workflows and status transitions?

Automate GitHub Projects v2 issue workflows by using the gh CLI with GraphQL verification to transition statuses, resolve option IDs, and prevent silent failures. This approach wraps validated operations to keep boards consistent and auditable without manual commands.

What's the best way to list and group GitHub project items by status field?

List and group GitHub project items by status field using gh CLI operations combined with jq for output processing. This fetches project items and displays epic-to-story relationships for quick board overviews in team repositories.

How do I create epics and stories in GitHub Projects v2 with parent links?

Create epics and stories in GitHub Projects v2 by running gh CLI operations that add parent links, set initial status, and add items to the project with validation. This ensures proper epic-to-story relationships and board consistency.

Do I need a specific GitHub token scope to manage Projects v2 via gh CLI?

You need gh CLI authenticated with a token that has project and repo scopes to manage Projects v2. Access to the target repository is also required, along with jq and git dependencies for GraphQL verification and output processing.

Why does my GitHub Projects v2 status transition fail silently?

GitHub Projects v2 status transitions fail silently when single-select Status option IDs are not properly resolved. The Skill prevents this by using GraphQL verification to validate option ID resolution before applying status updates.

Can I post attributed comments and assign users to issues via gh CLI?

Post attributed comments and assign users to issues via gh CLI operations that include role-attributed comments and user assignment. This documents each workflow step with attribution and handles common project-management tasks with robust error handling.