GitHub Milestone Analyzer

VerifiedSafe

Analyzes GitHub milestone progress: shows status of a specific version (open/closed issues, description) or lists all open milestones. Helps when discussing release versions or tracking project milestones.

Sby Skills Guide Bot
DevelopmentIntermediate
906/2/2026
Claude Code
#github-milestone#release-management#project-tracking

Recommended for

Our review

Analyzes and summarizes the status of a GitHub milestone by version number, or lists all open milestones.

Strengths

  • Structured report with issue progress (open/closed)
  • Automatic mode detection (status vs list)
  • Extraction of key issues marked with 🎯 emoji
  • Native GitHub API usage for up-to-date data

Limitations

  • Limited to the `zeroae/zae-limiter` repository (specific fork)
  • Requires a GitHub token with milestone access
  • No support for closed milestones in list mode
When to use it

When you need to check the progress of an upcoming release or list open milestones in a repository.

When not to use it

If the repository does not follow the 'v' version convention or if you need historical data on closed milestones.

Security analysis

Safe
Quality score85/100

This skill only uses read-only GitHub CLI commands (gh api, gh issue list, gh issue view) against a specific repository. There is no execution of arbitrary code, network requests outside GitHub's API, or modification of data. The allowed tools are non-destructive and safe for automated use.

No concerns found

Examples

Check milestone status
/milestone 1.0.0
List open milestones
/milestone list

description: When users mention a milestone version (e.g., "0.4.0", "v0.4.0") or ask about release status, invoke this skill to analyze GitHub milestone progress, issues, and suggest next steps. argument-hint: [version] | list allowed-tools: Bash(gh api:), Bash(gh issue list:), Bash(gh issue view:*) context: fork model: haiku

Milestone Skill

Analyze and summarize GitHub milestone status.

Modes

| Mode | Trigger | Purpose | |------|---------|---------| | Status | /milestone 1.0.0, /milestone v0.7.0 | Analyze specific milestone | | List | /milestone list, /milestone (no args) | Show all open milestones |

Mode Detection

  1. If version number provided (e.g., 1.0.0, v0.7.0, 0.5) → Status mode
  2. If list keywordList mode
  3. If no argumentsList mode

Status Mode

Extract the version from the user input. Normalize it (add "v" prefix if missing, e.g., 1.0.0v1.0.0).

Run these commands (replace VERSION with the normalized version):

Step 1: Get milestone details:

gh api repos/zeroae/zae-limiter/milestones --jq '.[] | select(.title == "VERSION") | {title, description, state, open_issues, closed_issues}'

Step 2: List all issues:

gh issue list --milestone "VERSION" --state all --json number,title,state,labels --jq '.[] | "\(.state)\t#\(.number)\t\(.title)"'

Step 3: If any issue title starts with "🎯", get its body:

gh issue view <number> --json title,body

See status.md for output format.

List Mode

Run this command:

gh api repos/zeroae/zae-limiter/milestones --jq '.[] | "- \(.title): \(.description)"'

Output the results.

Related skills