milestone-summary

Generate structured GitHub milestone retrospective summaries from git history, merged PRs, and ADRs.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/olivermorgan2/workflow-generator --skill milestone-summary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: milestone-summary
Source: https://github.com/olivermorgan2/workflow-generator/tree/main/skills/milestone-summary
Command: npx skills add https://github.com/olivermorgan2/workflow-generator --skill milestone-summary

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

This skill eliminates the manual overhead of compiling project retrospectives by automatically aggregating git logs, GitHub milestone data, and accepted ADRs into a structured summary document.

Core Features & Use Cases

  • Automated Retrospective Generation: Creates a comprehensive milestone summary file including shipped features, fixes, ADRs, and deferred work.
  • Template-Driven Output: Uses standardized templates to ensure consistency across all project milestones.
  • Use Case: Use this at the end of a development phase to generate a professional retrospective report that captures the project's progress and lessons learned without manually auditing every PR and issue.

Quick Start

Run the milestone-summary skill for milestone number 5 to generate a retrospective report in the design milestones directory.

Frequently Asked Questions about milestone-summary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a retrospective summary for a GitHub milestone?

To generate a GitHub milestone retrospective, you can use an automated skill that aggregates git history, merged pull requests, and accepted ADRs into a structured markdown document. It requires authenticated GitHub CLI access and a predefined project template to map the data.

Can I automate documentation for project releases using git history and pull requests?

Yes, you can automate release documentation by aggregating git logs and merged pull requests into a standardized summary file. This captures shipped features, fixes, and deferred work without manually auditing every issue, ensuring consistency across project milestones.

Do I need the GitHub CLI to compile milestone summaries and ADRs?

Yes, authenticated GitHub CLI access is required to fetch milestone data, git history, and accepted architecture decision records. The CLI provides the necessary API access to aggregate project data into the retrospective markdown output.

What is the best way to document shipped features and deferred work at the end of a development phase?

The best way to document shipped features and deferred work is using a template-driven approach that automatically aggregates milestone data into a consistent file format. This eliminates manual overhead and captures lessons learned for team review and release planning.

Why does milestone retrospective generation require a predefined project template?

Milestone retrospective generation requires a predefined project template to map aggregated data into a consistent file format. The template ensures standardized documentation across all milestones, structuring shipped features, fixes, ADRs, and deferred work uniformly.

Does the milestone summary output include architecture decision records?

Yes, the milestone summary output includes accepted architecture decision records alongside shipped features, fixes, and deferred work. It aggregates ADRs from the project to provide comprehensive context for team review and release planning.