retro

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

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/TarunTeja44/portfolio --skill retro-tarunteja44
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/TarunTeja44/portfolio/tree/main/.agents/skills/gstack-retro
Command: npx skills add https://github.com/TarunTeja44/portfolio --skill retro-tarunteja44

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams lack visibility into how they actually work — who shipped what, when deep work happens, whether test coverage is improving, and how this week compares to last. This Skill automates the weekly retrospective by mining git history and turning raw commits into actionable team insights. ## Core Features & Use Cases - Commit & Metrics Analysis: Aggregates commits, PRs, insertions/deletions, test LOC ratio, and fix-vs-feature breakdown over configurable windows (24h, 7d, 14d, 30d). - Team-Aware Breakdown: Identifies each contributor, computes per-person focus areas, session patterns, and test discipline, then generates specific praise and growth suggestions anchored in real commits. - Work Pattern Detection: Builds hourly commit histograms, detects deep/medium/micro coding sessions via 45-minute gap analysis, and tracks consecutive-day shipping streaks. - Persistent Trend Tracking: Saves JSON snapshots to .context/retros/ and compares against prior retros to show week-over-week deltas in test ratio, velocity, and fix rate. - Use Case: At the end of a sprint, run the retro to get a leaderboard of contributions, a ship-of-the-week highlight, hotspot files with high churn, and a trends table showing whether code quality is improving. ## 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 a time window argument such as 7d, 14d, or 24h. It queries git log on the default branch, aggregates commits, LOC, test ratios, and sessions, then produces a formatted retrospective with per-contributor analysis.

What metrics does a git-based engineering retro track?

It tracks commits, PRs merged, insertions and deletions, test LOC ratio, fix-versus-feature commit mix, active days, detected coding sessions, LOC per session-hour, shipping streaks, and per-author focus areas. Results are saved as JSON snapshots for trend comparison.

Can I compare this week's engineering output to last week?

Yes. Use the compare argument to diff the current window against the prior same-length window. The skill also loads prior snapshots from .context/retros/ and shows deltas for test ratio, sessions, fix rate, and velocity.

Does the retro work for solo developers or only teams?

It works for both. With multiple contributors it produces a per-person leaderboard with praise and growth suggestions; with a single contributor it skips the team breakdown and delivers a deeper personal retro covering sessions, focus score, and time patterns.

Why does the retro need git config user.name set?

The skill uses git config user.name to identify you as the person running the retro, separating your commits from teammates. Without it, the per-author breakdown cannot label your contributions or compute your personal shipping streak.