init-milestones

Create and update GitHub milestones from version baselines via gh CLI.

84|5|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/fitlab-ai/agent-infra --skill init-milestones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-milestones
Source: https://github.com/fitlab-ai/agent-infra/tree/main/.agents/skills/init-milestones
Command: npx skills add https://github.com/fitlab-ai/agent-infra --skill init-milestones

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Automates the setup of GitHub milestones to standardize issue tracking and release planning across a repository.

Core Features & Use Cases

  • Create General Backlog milestone as fallback for unsorted work.
  • Create major.minor.x line milestones and major.minor.next release milestone based on version baseline.
  • Optional history mode to generate milestones from vX.Y.Z tags (open/closed) and enforce idempotency across runs.
  • Idempotent creation via milestone titles, with summary output and error handling.

Quick Start

Run the initialization script to create and synchronize your repository milestones.

Frequently Asked Questions about init-milestones

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

FAQPage Schema
How do I automate GitHub milestones setup for a new repository?

You can automate GitHub milestones setup by running an initialization script that detects version baselines from v* tags or package.json and creates general backlog, line, and next release milestones via the GitHub API.

Do I need the GitHub CLI to create milestones from version tags?

Yes, you need the GitHub CLI (gh) along with Git and Node.js installed. The script uses these dependencies to detect version baselines from v* tags or package.json and to create or update milestones via the GitHub API.

Can I generate milestones from historical vX.Y.Z tags in GitHub?

Yes, you can enable an optional history mode to process tag-based milestones. This mode generates milestones from vX.Y.Z tags, handling both open and closed states, while enforcing idempotency across multiple runs.

What is the best way to manage major.minor.x line milestones for releases?

The best way to manage major.minor.x line milestones is to use an automation script that detects your current version baseline and automatically creates corresponding line milestones alongside a major.minor.next release target.

Why does running the milestone creation script multiple times duplicate entries?

Milestone creation should not duplicate entries because the script enforces idempotency via milestone titles. If duplicates appear, ensure the script successfully matched existing milestone titles during its GitHub API update checks.

Does this milestone automation tool work without a package.json file?

Yes, the tool works without a package.json file by falling back to detect version baselines from v* tags in your Git history. It uses Node.js and Git to establish the baseline for creating your repository milestones.