generate-roadmap

Generate a roadmap by fetching Epics and computing timelines based on story points and team velocity. This Skill creates a Mermaid Gantt chart visualization showing Epics, milestones, and dependencies across a configurable quarterly horizon, with output in Mermaid or Markdown format.

Yes. This Skill analyzes dependencies between Epics and renders them as Mermaid Gantt charts with linked tasks, showing which Epics block others and how they sequence. Duration is estimated from story points divided by team velocity.

Aggregate Epic data and apply velocity-based duration estimation to build structured roadmaps. This Skill fetches all Epics, computes realistic timelines, maps dependencies, and outputs both visual Gantt charts and formatted roadmap documents with status sections.

The Skill includes a configurable option to include or exclude completed Epics. By default it focuses on active work, but you can toggle include_completed to show historical Epics alongside future milestones for full-scope visibility.

Roadmap generation requires Bash, the GitHub CLI (gh), and jq for JSON processing. Epics must be defined in your repository; the Skill fetches them via GitHub API and outputs Mermaid syntax compatible with markdown viewers and documentation platforms.

Accuracy depends on story point estimates and measured team velocity. The Skill divides total Epic points by velocity to compute duration; if velocity or point estimates drift, timelines will shift proportionally. Regularly recalibrate velocity to keep forecasts aligned.