retro

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

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/dhnpmp-tech/project-agent --skill retro-dhnpmp-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/dhnpmp-tech/project-agent/tree/main/.claude/skills/gstack/retro
Command: npx skills add https://github.com/dhnpmp-tech/project-agent --skill retro-dhnpmp-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams lack visibility into how work actually happened over a week or sprint — who shipped what, when deep work occurred, whether test coverage kept pace, and how output trends over time. Manually assembling this from git history is tedious and rarely done consistently. ## Core Features & Use Cases - Commit and code metrics: Aggregates commits, insertions, deletions, test LOC ratio, PR size distribution, and file churn hotspots from git history over configurable windows (24h, 7d, 14d, 30d). - Team-aware analysis: Identifies the current user via git config, then breaks down per-contributor commits, focus areas, session patterns, and test discipline with specific praise and growth suggestions. - Work pattern detection: Builds hourly commit histograms, detects coding sessions using a 45-minute gap threshold, tracks shipping streaks, and computes focus scores. - Persistent history and trends: Saves retro snapshots to .context/retros/ and compares against prior runs, plus a compare mode for period-over-period deltas and a global mode across projects. - Use Case: At the end of a sprint, run /retro 14d to get a full report: a per-person leaderboard, week-over-week test ratio trends, the biggest ship of the period, and concrete growth feedback for each teammate. ## Quick Start Ask the assistant to run a weekly engineering retrospective over the last 7 days of git history with per-contributor breakdowns and trend comparison.

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 /retro with no arguments to analyze the last 7 days of commits on the default branch. It gathers commit counts, LOC changes, test ratios, session patterns, and per-author breakdowns, then presents a formatted report with trends.

How to compare engineering output between two time periods?

Use /retro compare to analyze the current window against the prior same-length window, or /retro compare 14d for an explicit window. The report shows deltas for commits, LOC, test ratio, and session counts between periods.

Can I run a retrospective across multiple projects or repos?

Yes, /retro global runs a cross-project retrospective across all AI coding tools without requiring you to be inside a git repo. It defaults to a 7-day window, and /retro global 14d sets an explicit window.

Does the retro skill track individual team member contributions?

Yes, it identifies the current user via git config and analyzes every contributor separately. Each person gets commits, LOC, focus areas, session patterns, test discipline, plus specific praise and one growth suggestion anchored in actual commits.

What time windows does the retro command support?

Supported windows are hours (24h), days (7d, 14d, 30d), and weeks (2w). Day and week windows align to local midnight for accurate boundaries, while hour windows use relative offsets. Invalid arguments show a usage message.

Why does the retro report skip Greptile or backlog metrics?

Those rows only appear when the source data exists. Greptile signal requires ~/.gstack/greptile-history.md entries in the window, and Backlog Health requires a TODOS.md file in the repo. Missing files cause those rows to be skipped silently.