setup-github-project

Creates and reconciles GitHub repositories, milestones, and Projects V2 Ticket boards.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/bbenefield89/skills --skill setup-github-project-bbenefield89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-github-project
Source: https://github.com/bbenefield89/skills/tree/main/skills/setup-github-project
Command: npx skills add https://github.com/bbenefield89/skills --skill setup-github-project-bbenefield89

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up consistent GitHub planning infrastructure—private repositories, canonical release milestones, and a repository-linked Projects V2 Ticket board—requires many manual, error-prone steps. This Skill standardizes the entire setup and reconciliation process with approval gates and verification. ## Core Features & Use Cases - Repository Bootstrap: Detects or proposes a private GitHub repository, resolves the owner from authenticated accounts, and configures the remote without committing or pushing. - Canonical Milestone Reconciliation: Creates or reuses the five exact phase milestones (Prototype through Release) sequentially, validating each before proceeding and flagging ambiguous legacy milestones. - Projects V2 Board Configuration: Builds a private repository-linked Project with a single Tickets board view, Status options (Todo, In Progress, Done), Ticket-only membership, and automated workflows. - Use Case: A team starting a new game project needs its GitHub planning infrastructure standardized. Run this Skill to inspect the repository, propose the exact milestones, Project, views, and workflows to create, get approval, then execute and verify the full setup. ## Quick Start Ask the assistant to set up the GitHub Project planning infrastructure for this repository using the setup-github-project skill.

Frequently Asked Questions about setup-github-project

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

FAQPage Schema
How do I set up a GitHub Projects V2 board for issue tracking?

Run this Skill to create or reconcile a private repository-linked Project with a single Tickets board view filtered by the ticket label, Status columns (Todo, In Progress, Done), and Milestone slicing. Every change requires explicit approval before execution.

How do I create standard release milestones in a GitHub repository?

The reconcile-milestones script creates the five canonical milestones (Phase 1: Prototype through Phase 5: Release) sequentially, validating each before proceeding. Ambiguous or duplicate existing milestones are reported and require approval before any changes.

What GitHub CLI version is required for Projects V2 automation?

GitHub CLI 2.94.0 or newer is required, verified by the preflight script. You also need authenticated access with repo and project scopes, which can be granted via gh auth login or gh auth refresh -s project.

Can this tool modify existing GitHub milestones or Projects?

It reuses compatible existing milestones and Projects without changing their state. Legacy or conflicting configurations are detected and reported, but renaming, merging, closing, or deleting anything requires an exact approved migration.

Why does the setup stop before making any GitHub changes?

The Skill enforces a non-negotiable approval gate: it runs preflight and read-only inspection, presents the exact proposed mutations, and waits for explicit human approval. Failed prerequisites or ambiguous legacy configuration also halt execution.