retrospective

Generate sprint or milestone retrospectives from plans, completion status, and Git history.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill retrospective-windxran
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: retrospective
Source: https://github.com/WindXRan/y3td/tree/main/.claude/skills/retrospective
Command: npx skills add https://github.com/WindXRan/y3td --skill retrospective-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the effort and guesswork of writing sprint or milestone retrospectives by turning plans, completion status, and code-trend signals into a structured, actionable document.

Core Features & Use Cases

  • Retrospective generation from real sprint/milestone data: Synthesizes planned work, actual completion status (including production/sprint-status.yaml when available), and Git history into metrics and conclusions.
  • Trend and process insight extraction: Compares TODO/FIXME/HACK counts and reviews previous retrospectives to identify recurring issues and velocity shifts.
  • Actionable next-iteration outputs: Produces focused action items with owners and deadlines, then saves the result to production/retrospectives/ after explicit confirmation.

Quick Start

Run the retrospective skill for sprint 5 by providing the argument sprint-5, then review the generated document and choose whether to write it to production/retrospectives.

Frequently Asked Questions about retrospective

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

FAQPage Schema
How do I generate a sprint retrospective from git log and sprint data?▼

To generate a sprint retrospective, the Skill parses planned work from sprint or milestone folders, computes completion metrics from sprint-status.yaml, scans TODO/FIXME/HACK trends, and reviews Git history to produce actionable insights. Output is saved to production/retrospectives/ after explicit user confirmation.

What is velocity tracking and how does it work for milestone analysis?▼

Velocity tracking for milestone analysis works by computing completion and variance metrics from your planned work and actual sprint-status.yaml data. It compares these metrics against previous retrospectives to identify velocity shifts and recurring blockers, generating focused action items for the next iteration.

Can I use sprint-status.yaml to track process improvement and blockers?▼

Yes, you can use sprint-status.yaml to track process improvement and blockers. The Skill parses this optional file to compute actual completion facts, compares them against planned work, and scans TODO/FIXME/HACK trends to identify recurring issues that require process improvements.

How to extract action items from recurring patterns in previous retrospectives?▼

Extracting action items from recurring patterns requires parsing existing retrospectives alongside current sprint data. The Skill identifies recurring blockers and velocity shifts by comparing historical documents with current TODO/FIXME/HACK trends, then produces focused action items with owners and deadlines for the next iteration.

Does this retrospective generation work with milestone workflows or only sprints?▼

This retrospective generation works with both milestone and sprint workflows. It applies to workflows maintaining plans under production/sprints and production/milestones, optionally reading completion facts from production/sprint-status.yaml to analyze completed work and generate actionable improvements.

What are the limitations of automated sprint analysis for next-iteration improvements?▼

Automated sprint analysis requires maintaining plans under production/sprints or production/milestones and optionally completion facts in production/sprint-status.yaml. It cannot generate improvements without existing Git history or planned work data, and saving output requires explicit user approval before writing to production/retrospectives/.