# Create Milestone

Create a GitHub milestone for an upcoming release.

- Repository: https://github.com/agentic-community/mcp-gateway-registry (1032 stars)
- Category: Git and review
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentic-community/mcp-gateway-registry --skill create-milestone -g -a claude-code -y`
Codex: `npx skills add agentic-community/mcp-gateway-registry --skill create-milestone -g -a codex -y`
Cursor: `npx skills add agentic-community/mcp-gateway-registry --skill create-milestone -g -a cursor -y`
Gemini CLI: `npx skills add agentic-community/mcp-gateway-registry --skill create-milestone -g -a gemini-cli -y`

## Description

Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all merged PRs and closed issues since that release, presents a draft with two tables (Issues and PRs) for user approval, then creates the milestone and assigns all approved items.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Create Milestone Skill

Use this skill when the user wants to plan and create a GitHub milestone for an upcoming release. The skill identifies what has changed since a baseline release, presents a draft for approval, and creates the milestone with all approved items.

Supports creating multiple milestones in sequence (e.g., v1.0.20, v1.0.21) by letting the user choose the baseline and which items belong to which release.

## Input

The skill accepts optional parameters:

```
/create-milestone [VERSION] [DATE] [NOTES]
```

- **VERSION** - Target version (e.g., `v1.0.20`). If not provided, suggest based on latest release.
- **DATE** - Target release date (e.g., `2026-04-21`). If not provided, ask the user.
- **NOTES** - Optional theme or notes (e.g., "security hardening", "federation improvements").

## Output

- A GitHub milestone with description containing two tables (Issues and PRs)
- A local draft file at `.scratchpad/{version}-release-notes.md` with detailed release notes

## Workflow

### Step 1: Discover Releases and Milestones

Gather the current state of releases and milestones:

```bash
# Get recent releases (tags + dates)
gh release list --limit 10 --json tagName,publishedAt,name \
  --jq '.[] | "\(.tagName)\t\(.publishedAt)\t\(.name)"'

# Get existing milestones (to avoid duplicates and show what's already planned)
gh api repos/{owner}/{repo}/milestones --jq '.[] | "\(.number)\t\(.title)\t\(.due_on)\t\(.open_issues)\t\(.closed_issues)"'

# Git tags for reference
git tag --sort=-v:refname | grep '^v[0-9]' | head -10
```

### Step 2: Ask the User What They Want

Present findings and ask the user to specify:

1. **Which version** to create a milestone for (suggest next patch bump from latest release)
2. **Target date** for the release
3. **Baseline release** to diff from -- this is critical for flexibility
4. **Theme or notes** for this release

**Example prompt:**

The rest: https://github.com/agentic-community/mcp-gateway-registry/blob/HEAD/.claude/skills/create-milestone/SKILL.md