retro

Generates weekly engineering retrospectives from git commit history with per-contributor metrics and trend tracking.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill retro-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/gstack/retro
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill retro-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams lack visibility into what actually shipped each week, how work patterns affect output, and whether code quality is trending up or down. This Skill turns raw git history into a structured retrospective with metrics, per-person breakdowns, and historical trend tracking. ## Core Features & Use Cases - Commit and Metrics Analysis: Aggregates commits, PRs, insertions/deletions, test LOC ratio, and active days over a configurable window (24h, 7d, 14d, 30d). - Team-Aware Breakdowns: Identifies the current user via git config and produces a per-author leaderboard with praise and growth areas for each contributor. - Work Pattern Detection: Builds hourly commit histograms, detects coding sessions using a 45-minute gap threshold, and flags late-night clusters and fix-ratio spikes. - Comparison and Global Modes: Compares the current window against the prior period, or runs a cross-project retro across all AI coding tools. - Use Case: At the end of a sprint, run the retro to see that fixes made up 54% of commits, two files churned 8+ times, and your deep-focus sessions dropped versus last week, then act on those signals. ## Quick Start Ask the assistant to run a weekly engineering retrospective over the last 7 days of this repository's commit history.

Frequently Asked Questions about retro

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

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

Run the retro skill with no arguments to analyze the last 7 days of commits on the default branch. It aggregates commits, LOC changes, test ratios, and session patterns into a metrics table with a per-author leaderboard.

How to compare this sprint's engineering output to the previous one?

Use the compare mode with an optional window, such as the last 14 days versus the prior 14 days. The skill computes both windows from midnight-aligned dates and reports the deltas in commits, LOC, and activity patterns.

Does the retro skill work with GitLab or only GitHub?

It supports both. The skill detects the platform from the git remote URL, falling back to gh or glab CLI authentication checks, and uses git-native commands when neither CLI is available.

Can I run a retrospective across multiple projects at once?

Yes, the global mode runs a cross-project retro across all AI coding tools and does not require being inside a git repository. Pass an optional window like 14d to control the time range.

What time windows does the engineering retro support?

It accepts hours, days, and weeks, such as 24h, 7d, 14d, or 30d, defaulting to 7 days. Day and week windows are aligned to local midnight so results are consistent regardless of when you run the command.