retro

Analyzes git commit history to generate weekly engineering retrospectives with per-contributor metrics and trends.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/fullya99/simple-blog-page --skill retro-fullya99
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/fullya99/simple-blog-page/tree/main/.claude/skills/gstack/retro
Command: npx skills add https://github.com/fullya99/simple-blog-page --skill retro-fullya99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams and solo developers lack visibility into their own work patterns: when they code, how much they ship, test coverage discipline, and whether velocity is improving week over week. Manually digging through git history to answer these questions is tedious and rarely done consistently. ## Core Features & Use Cases - Commit and session analysis: Parses git log to compute commits, LOC, test ratios, PR sizes, hotspot files, and detects work sessions using a 45-minute gap threshold. - Team-aware breakdowns: Identifies the current user via git config and produces per-contributor sections with specific praise and growth suggestions anchored in actual commits. - Persistent trend tracking: Saves JSON snapshots to .context/retros/ and compares against prior runs to show week-over-week deltas in velocity, test ratio, and session depth. - Use Case: A tech lead runs /retro every Friday to get a data-backed summary of the team's week, including shipping streaks, focus scores, and the highest-impact PR, ready to share in a team sync. ## Quick Start Type /retro to analyze the last 7 days of commits, or /retro compare 14d to compare this period against the prior one.

Frequently Asked Questions about retro

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

FAQPage Schema
How do I analyze my team's git commit history for a weekly retrospective?▼

Run /retro to analyze the last 7 days of commits on origin/main. It computes commits, LOC, test ratios, session patterns, and per-author breakdowns, then writes a narrative report with praise and growth suggestions for each contributor.

How to compare engineering velocity between two time periods in git?▼

Use /retro compare or /retro compare 14d. It computes metrics for the current window and the immediately prior same-length window using --since and --until, then shows a side-by-side delta table with a narrative on improvements and regressions.

What time windows does the retro command support?▼

Supported windows are hours, days, and weeks: /retro 24h, /retro 14d, /retro 30d, with 7 days as the default. Invalid arguments trigger a usage message and stop execution.

Does the retro skill work for solo repositories with one contributor?▼

Yes. When only one contributor is detected, the team breakdown is skipped and the retro becomes a personal deep-dive covering your sessions, peak hours, focus score, and biggest ship.

Where does the retro skill store historical data?▼

Snapshots are saved as JSON files in .context/retros/ named by date and sequence number. On subsequent runs the most recent snapshot is loaded to compute trend deltas for metrics like test ratio, sessions, and LOC per hour.

Why does the retro show no commits for my selected window?▼

The skill queries origin/main, not your local branch, so a stale local fetch or a window with no merged commits produces an empty result. It fetches origin first and tells you to pick a different window if nothing is found.