milestone-tracker

Milestone Tracker Skill

Purpose

Fetch and summarize milestone progress when the user asks about completion status, remaining work, or sprint metrics. This is a read-only skill.

When to Use This

• User asks "milestone progress?"
• User asks "how many issues left?"
• User asks "completion percentage"
• User asks "what's left in the sprint?"
• User mentions milestone tracking

Commands

List All Milestones

gh api repos/joeczar/code-graph-mcp/milestones --jq '.[] | {number, title, open_issues, closed_issues, due_on, state}'

Get Specific Milestone

gh api repos/joeczar/code-graph-mcp/milestones/<number>

Get Issues in Milestone

gh issue list --milestone "<milestone-name>" --state all --json number,title,state,labels

Calculate Progress

Completion % = (closed_issues / (open_issues + closed_issues)) * 100

Current Milestones

Output Format

## Milestone: <name>

**Progress:** X/Y issues (Z%)
**Due:** <date or "No due date">

### Progress Bar
[████████░░░░░░░░░░░░] 40% (8/20)

### By Status
- Done: <count>
- In Progress: <count>
- Not Started: <count>

### Recently Completed
- #X: <title>
- #Y: <title>

### Up Next (Open)
- #A: <title>
- #B: <title>

Progress Bar Generation

Generate visual progress:

# Calculate percentage
OPEN=$(gh api repos/joeczar/code-graph-mcp/milestones/<n> --jq '.open_issues')
CLOSED=$(gh api repos/joeczar/code-graph-mcp/milestones/<n> --jq '.closed_issues')
TOTAL=$((OPEN + CLOSED))
PCT=$((CLOSED * 100 / TOTAL))

# Generate bar (20 chars)
FILLED=$((PCT / 5))
EMPTY=$((20 - FILLED))
BAR=$(printf '█%.0s' $(seq 1 $FILLED))$(printf '░%.0s' $(seq 1 $EMPTY))
echo "[$BAR] $PCT% ($CLOSED/$TOTAL)"

Full Status Report

# Get all milestones with progress
gh api repos/joeczar/code-graph-mcp/milestones --jq '.[] | "\(.title): \(.closed_issues)/\(.open_issues + .closed_issues) (\(.closed_issues * 100 / ((.open_issues + .closed_issues) | if . == 0 then 1 else . end))%)"'