skills.rest
BeiBei-Clic
BeiBei-ClicCOMMUNITY
Explore all skills by this author →
GitHub

gsd-milestone-summary

Generate a structured milestone summary report from planning artifacts.

Updated Aug 27, 2026
Search Tags:#requirements#report generation#retrospective#team onboarding#project review#planning artifacts#milestone summary
One-click install
npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-milestone-summary-beibei-clic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-milestone-summary
Source: https://github.com/BeiBei-Clic/ai-skills/tree/main/gsd-milestone-summary
Command: npx skills add https://github.com/BeiBei-Clic/ai-skills --skill gsd-milestone-summary-beibei-clic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the challenge of onboarding and review by transforming scattered milestone artifacts into one coherent milestone summary that people can read quickly and ask meaningful follow-up questions.

Core Features & Use Cases

  • Milestone artifact synthesis: Reads planning artifacts such as ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, and related phase documents to produce a single structured overview.
  • Team onboarding & review readiness: Creates an easy-to-consume briefing that helps new team members understand what was built, how, and why.
  • Deliverable reporting: Writes a milestone summary report to .planning/reports/MILESTONE_SUMMARY-v{version}.md, presents it inline, and updates STATE.md to reflect progress.

Quick Start

Run the gsd-milestone-summary skill to generate the latest milestone report in .planning/reports/ and update STATE.md using your current version context.

Frequently Asked Questions about gsd-milestone-summary

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

FAQPage Schema
How do I generate a milestone summary from existing project planning artifacts?▼

To generate a milestone summary, the Skill reads existing planning artifacts like ROADMAP, REQUIREMENTS, CONTEXT, and VERIFICATION, then synthesizes them into a single structured brief. It writes the report to .planning/reports/MILESTONE_SUMMARY-v{version}.md and updates STATE.md.

What is the best way to create a team onboarding brief from a project milestone?▼

Creating a team onboarding brief involves transforming scattered milestone artifacts into one coherent summary. This allows new team members to quickly understand what was built, how, and why, by reading a structured overview instead of navigating multiple phase documents.

How does report generation work for archived milestone scans and phase documents?▼

Report generation for archived milestone scans works by reading existing phase documents like RESEARCH and RETROSPECTIVE. The process resolves the milestone version, aggregates the data, and outputs a structured MILESTONE_SUMMARY-v{version}.md file inside the .planning/reports/ directory.

Do I need specific planning artifacts to create a project review summary?▼

Yes, you need specific planning artifacts to create a project review summary. The process requires resolving a milestone version and reading files including ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, and RETROSPECTIVE to synthesize the final briefing.

Can I update STATE.md automatically when generating a milestone report?▼

Yes, you can update STATE.md automatically when generating a milestone report. The synthesis process writes the deliverable to .planning/reports/, presents the results inline, and simultaneously updates STATE.md to reflect the current project progress.

Related Skills

Explore More Product & Management Skills→
yusaduymazyusaduymaz

gsd-milestone-summary

Synthesize milestone artifacts into a structured onboarding-ready project summary.

Community
Advanced
aslaiiaslaii

gsd-milestone-summary

Consolidate milestone artifacts into a structured MILESTONE_SUMMARY report.

Community
Advanced
tinner-deinnotinner-deinno

gsd-milestone-summary

Compile milestone artifacts into a structured summary report.

Community
Intermediate
mvillmowmvillmow
18

phase-cleanup

Refactor code and update documentation after parallel development phases complete.

Community
Intermediate