project-board-manager

Coordinate GitHub Issues on a Kanban board using GitHub Projects v2.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/balamuru/antigravity-dev-skills --skill project-board-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-board-manager
Source: https://github.com/balamuru/antigravity-dev-skills/tree/main/.agents/skills/project-board-manager
Command: npx skills add https://github.com/balamuru/antigravity-dev-skills --skill project-board-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridges the gap between raw GitHub Issues and a visual Kanban board by using GitHub Projects to orchestrate project states and improve visibility across the repository.

Core Features & Use Cases

  • Board Initialization: Creates or ensures a GitHub Projects board exists for the repository using the gh project create command and explicitly links it to the repository with gh project link so it appears under the repository's Projects tab.
  • Issue Linking: Reads the generated task.md for issue numbers and links them to the project board using gh project item-add, enabling centralized tracking.
  • Board Organization: Sets up standard Kanban columns such as Todo, In Progress, In Review, and Done, and updates item states as work progresses (e.g., when a branch is created or a PR is merged) using gh project item-edit if needed.
  • Use Case: Teams adopting a single source of truth for project state can automatically reflect issue progress on a shared Kanban board, reducing context switching and improving visibility.

Quick Start

Create and link a GitHub Project board for the current repository and attach generated issues to it.

Frequently Asked Questions about project-board-manager

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

FAQPage Schema
How do I link GitHub Issues to a Kanban board automatically?

You can set up a GitHub Projects board with standard Kanban columns like Todo, In Progress, In Review, and Done using the gh project CLI. The board is explicitly linked to your repository so it appears under the Projects tab for centralized visibility.

Can I use GitHub Projects to track repository issues on a single board?

Yes, GitHub Projects supports custom Kanban columns like Todo, In Progress, In Review, and Done. You can organize your repository issues across these standard columns and update item states automatically as branches are created or PRs are merged.

Do I need the gh project CLI to automate GitHub Kanban board setup?

Yes, you need the gh project CLI to automate GitHub Kanban board setup. It provides the necessary commands to create the project, link it to your repository, add items from task.md, and edit item states as work progresses.

How does task.md integrate with GitHub Projects for issue linking?

The task.md file integrates with GitHub Projects by serving as the source for issue numbers. The automation reads this file to gather the generated issues and then uses the gh project item-add command to link them directly to your Kanban board.

What is the best way to maintain issue progress visibility on a shared Kanban board?

The best way to maintain issue progress visibility is to bridge raw GitHub Issues to a centralized GitHub Projects board. Using gh project item-edit updates card states dynamically, ensuring the shared Kanban board reflects current work status.