create-milestone

name	create-milestone
description	Create a GitHub milestone for Jamie-BitFlight/claude_skills. No args: guided intake (title, due date, description). With 'quick {title}': minimal prompts. Creates milestone via gh api REST, checks for duplicates. Returns milestone number for use with group-items-to-milestone. Use when starting a new sprint, release, or theme grouping of backlog items.
argument-hint	[quick {title}]
user-invocable	true

Create Milestone

Create a GitHub milestone on Jamie-BitFlight/claude_skills and return its number for downstream use.

REST API reference: milestones.md

Arguments

• Empty — guided intake via AskUserQuestion
• quick {title} — use remainder as title, ask only for due date and description

Workflow

Step 1: Collect Fields

Guided mode (no args) — ask in sequence:

Q1: Milestone title?  (e.g. "v1.1 — Milestone Workflow", "2026-Q1 Grooming")
Q2: Due date? (YYYY-MM-DD, or skip)
Q3: Description? (one sentence, or skip)

Quick mode (quick {title}) — ask only Q2 and Q3.

Title is required. Due date and description are optional.

Step 2: Duplicate Check

gh api repos/Jamie-BitFlight/claude_skills/milestones \
  --jq '.[] | select(.state=="open") | .title'

If an open milestone with the same title already exists, report it and ask: "Use existing or create new?" via AskUserQuestion.

If user chooses existing: print its number and stop.

Step 3: Create Milestone

Use the Python script (preferred — returns structured output):

uv run .claude/skills/gh/scripts/github_project_setup.py milestone create \
  --repo Jamie-BitFlight/claude_skills \
  --title "{title}" \
  --description "{description}" \
  --due "{YYYY-MM-DD}"

Omit --due if not provided. Omit --description if not provided.

Capture the milestone number from the output line Created milestone #{number}: ….

Step 4: Confirm

Milestone created.

  Title:   {title}
  Number:  #{number}
  Due:     {due date or "not set"}
  URL:     https://github.com/Jamie-BitFlight/claude_skills/milestone/{number}

Next steps:
  Assign items:  /group-items-to-milestone {number}
  Start work:    /start-milestone {number}

Error Handling

• gh not installed: run uv run .claude/skills/gh/scripts/setup_gh.py first.
• GITHUB_TOKEN missing: report and stop.
• Duplicate found and user picks existing: print existing milestone number and next-step commands, stop.
• API error: print full response and stop.