retro

Analyze git history to generate engineering retrospectives with shipping trends and code quality signals.

1|Updated May 18, 2026
One-click install
npx skills add https://github.com/linenoize/topia --skill retro-linenoize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/linenoize/topia/tree/main/skills/retro
Command: npx skills add https://github.com/linenoize/topia --skill retro-linenoize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns raw git activity into a clear engineering retrospective so teams can understand what shipped, how work is trending, and where quality or focus is slipping.

Core Features & Use Cases

  • Work Pattern Analysis: Measures commits, contributors, sessions, active days, and hourly activity to reveal how the team actually works.
  • Quality and Churn Signals: Identifies fix-heavy periods, churn hotspots, missing test coverage, and files that deserve refactoring attention.
  • Trend and Memory Tracking: Compares current performance with prior retros, tracks shipping streaks, and saves structured snapshots for long-term review.
  • Use Case: A team lead asks for a weekly review after a sprint and gets a candid retrospective with metrics, praise, risks, and concrete habits for the next week.

Quick Start

Ask the assistant to run a seven-day engineering retro for the current repository and return a concise report with metrics, hotspots, trends, and next-step habits.

Frequently Asked Questions about retro

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

FAQPage Schema
How do I generate an engineering retrospective from git history?

To generate an engineering retrospective from git history, you parse commit data to analyze shipping trends, code quality signals, and team work patterns. This produces a structured report covering metrics, hotspots, and actionable habits for your next sprint or weekly review.

What are code churn hotspots and how do I detect them in commit analysis?

Code churn hotspots are files with frequent changes or fix-heavy activity that need refactoring. You detect them through commit analysis by parsing git history to identify high-churn areas and missing test coverage, revealing where code quality is slipping.

Can I compare current git commit trends with previous sprint reviews?

Yes, you can compare current git commit trends with previous sprint reviews using compare-mode analysis. The process tracks shipping streaks and saves structured JSON snapshots from prior retros, allowing you to measure performance shifts and long-term work pattern trends.

Does this git retrospective analysis work for repositories with multiple contributors?

Yes, this git retrospective analysis works across repositories with one or more contributors. It measures individual commits, active days, and hourly activity to reveal team work patterns, making it suitable for both solo projects and collaborative engineering teams.

How do I track team work patterns and active days from git commits?

You track team work patterns and active days from git commits by parsing commit history and grouping related activity into sessions. This analysis measures hourly activity and contributor engagement to reveal how the engineering team actually works over weekly or monthly periods.

What is the best way to run a weekly code quality retrospective for a development team?

The best way to run a weekly code quality retrospective is to analyze a seven-day window of git history to extract fix-heavy periods, churn hotspots, and missing test coverage. This generates a candid report with metrics, risks, and concrete habits for the next week.