gh-labels-milestones

Bootstrap and sync GitHub labels and milestones idempotently with gh CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap and synchronize GitHub labels and milestones across repositories so they stay consistent without manual upkeep.

Core Features & Use Cases

  • Idempotent upsert of labels and milestones to create missing items and update existing ones when colors or descriptions differ.
  • Bootstrap labels and milestones for new projects and ensure CI pipelines reflect the correct state.
  • Assign labels to issues by coordinating with milestones to keep work tracked across phases.

Quick Start

Run maple labels to bootstrap and sync your repository's GitHub labels and milestones.

Frequently Asked Questions about gh-labels-milestones

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

FAQPage Schema
How do I synchronize GitHub labels and milestones across multiple repositories?

To synchronize GitHub labels and milestones, you can use an idempotent upsert process that creates missing items and updates existing ones when colors or descriptions differ, ensuring consistent state across repositories without manual upkeep.

What is idempotent label bootstrapping in a CI workflow?

Idempotent label bootstrapping in a CI workflow means applying an upsert logic to GitHub labels and milestones so that running the pipeline multiple times produces the same consistent state without creating duplicates or overwriting unchanged data.

How do I bootstrap GitHub labels for a new project using the gh CLI?

You can bootstrap GitHub labels for a new project by running a sync command that queries existing state via gh CLI commands and applies idempotent upserts to create or edit labels and milestones to match your desired configuration.

Can I update existing GitHub label colors and descriptions without deleting them?

Yes, you can update existing GitHub label colors and descriptions without deleting them by using an idempotent upsert mechanism that detects differences and applies edits to align the current state with your target definitions.

Does this label syncing approach work for CI pipelines to guarantee consistent repository state?

Yes, this label syncing approach is specifically designed for CI pipelines to guarantee consistent label and milestone state across repositories by applying idempotent upserts during workflow runs to prevent configuration drift.

When should I use an idempotent upsert for GitHub milestones and labels?

You should use an idempotent upsert for GitHub milestones and labels during initial project setup and within CI workflows whenever you need to enforce consistent tracking categories across multiple repositories without risking duplication.