retro

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

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/psyche911/AntigravityTest --skill retro-psyche911
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/psyche911/AntigravityTest/tree/main/.claude/skills/gstack/retro
Command: npx skills add https://github.com/psyche911/AntigravityTest --skill retro-psyche911

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams and solo developers lack visibility into their actual work patterns—commit velocity, test discipline, session habits, and code churn—making it hard to run data-driven retrospectives without manual git archaeology. ## Core Features & Use Cases - Commit & Velocity Analysis: Aggregates commits, PRs, insertions/deletions, test LOC ratio, and commit-type breakdown (feat/fix/refactor) from origin/main over configurable windows (24h, 7d, 14d, 30d). - Team-Aware Breakdown: Identifies the current user via git config, then produces per-contributor leaderboards with specific praise and growth suggestions anchored in real commits. - Session & Streak Detection: Detects coding sessions using a 45-minute gap threshold, tracks consecutive-day shipping streaks, and charts hourly commit distribution in Pacific time. - Persistent Trend Tracking: Saves JSON snapshots to .context/retros/ and compares current metrics against prior retros, plus a compare mode for window-over-window deltas. - Use Case: A tech lead runs /retro 14d every Friday to get a per-person summary of the sprint—who shipped what, test coverage trends, and three concrete habits to adopt next week. ## Quick Start Run /retro to generate a retrospective of the last 7 days of commits on origin/main, 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 generate a weekly engineering retrospective from git history?▼

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

How to compare this week's commits against last week 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 of 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 display a usage message and stop.

Does the retro skill work for solo repositories?▼

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?▼

It saves JSON snapshots to .context/retros/ named by date and sequence number. On subsequent runs it loads the most recent snapshot to compute trend deltas for metrics like test ratio, sessions, and LOC per hour.

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

The skill queries origin/main, not your local branch, so unpushed or unmerged work is excluded. If the window has zero commits it says so and suggests trying a longer window.