roadmap

name	roadmap
description	Query GitHub Issues for roadmap priorities and status
allowed-tools	Bash, Read, Write
user-invocable	true
automation	manual
metadata	{"version":"1.1","created":"2026-03-13T00:00:00.000Z","author":"Ability.ai","changelog":["1.1: Added epics, themes, and orphans subcommands — Epic rollup with progress bars, coverage by strategic theme, and detection of issues missing an Epic or Theme.","1.0: Initial version — queries GitHub Issues for roadmap priorities, blockers, and work status."]}

Roadmap

ℹ️ First, set expectations: before anything else, print one short line with this skill's version and its most recent change — the top entry of metadata.changelog above — e.g. roadmap vX.Y — recent: <summary>. Then proceed.

Query GitHub Issues to check current priorities, blockers, and work status.

State Dependencies

Source	Location	Read	Write
GitHub Issues	GitHub repo	Yes	No
GitHub Labels	priority-p0/p1/p2/p3, type-, status-	Yes	No

Process

Step 1: Parse Command Arguments

• /roadmap or /roadmap status -> Show P0/P1 priorities
• /roadmap all -> Show all open issues by priority
• /roadmap blockers or /roadmap blocked -> Show blocked items
• /roadmap in-progress -> Show items being worked on
• /roadmap epics -> Epic rollup with progress bars
• /roadmap themes -> Coverage by strategic theme
• /roadmap orphans -> Issues missing Epic or Theme field
• /roadmap create <title> -> Create a new issue

Step 2: Query GitHub Issues

For status (default):

gh issue list --label "priority-p0" --state open --json number,title,labels,assignees
gh issue list --label "priority-p1" --state open --json number,title,labels,assignees

For all:

gh issue list --state open --json number,title,labels,assignees --limit 50

For blockers:

gh issue list --label "status-blocked" --state open --json number,title,labels,assignees

For in-progress:

gh issue list --label "status-in-progress" --state open --json number,title,labels,assignees

Step 3: Format Output

Present results in a clear table format.

Step 4: Epics Rollup (if epics argument)

# Get all issues with an Epic field set
gh issue list --state open --json number,title,labels,projectItems --limit 200

For each unique Epic value, compute:

• Total child issues
• Issues by status (todo / in-progress / in-dev / done)
• Completion percentage

Output as a table with progress bars:

Epic: #20 Audit Trail
  ████████░░░░  67%  (8/12 done)
  In Progress: #42, #43
  Todo: #55, #56

Step 5: Themes Coverage (if themes argument)

gh issue list --state open --json number,title,labels --limit 200

Group by Theme field. For each theme, show:

• Open issue count
• Priority distribution (P0/P1/P2/P3)

Theme: Security (4 issues — P0: 1, P1: 2, P2: 1)
Theme: Reliability (7 issues — P1: 3, P2: 4)
Theme: UI/UX (2 issues — P2: 2)

Step 6: Orphans (if orphans argument)

Find issues missing an Epic or Theme assignment:

gh issue list --state open --json number,title,labels,projectItems --limit 200

Filter for issues where Epic or Theme project fields are empty. Output as a list for grooming.

Step 7: Create Issue (if requested)

If user runs /roadmap create <title>:

1. Ask for priority and type
2. Create issue with labels
3. Return the issue URL

Quick Commands

Command	Description
/roadmap	Show P0/P1 priorities
/roadmap all	All open issues
/roadmap blocked	Blocked items
/roadmap in-progress	Work in progress
/roadmap epics	Epic rollup with progress bars
/roadmap themes	Coverage by strategic theme
/roadmap orphans	Issues missing Epic or Theme
/roadmap create <title>	Create new issue

Completion Checklist

• Command arguments parsed correctly
• GitHub Issues queried successfully
• Results formatted as table
• GitHub link provided for full view