retro

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

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/bobbo01/B2BPlatform --skill retro-bobbo01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retro
Source: https://github.com/bobbo01/B2BPlatform/tree/main/.agents/skills/gstack-retro
Command: npx skills add https://github.com/bobbo01/B2BPlatform --skill retro-bobbo01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams lack visibility into what actually shipped each week, how work is distributed across contributors, and whether code quality patterns like fix-heavy commits or churn hotspots signal deeper problems. This Skill turns raw git history into a structured retrospective report. ## Core Features & Use Cases - Commit and Metrics Analysis: Aggregates commits, PRs, insertions/deletions, test LOC ratio, active days, and session detection from git history over configurable windows (24h, 7d, 14d, 30d). - Team-Aware Breakdown: Identifies the current user via git config and produces a per-author leaderboard with praise and growth areas for each contributor. - Pattern Detection: Surfaces commit time distributions, work session classification, commit type breakdowns, hotspot files, and PR size buckets, flagging signals like fix ratios above 50%. - Use Case: At the end of a sprint, run the retro to get a report showing who shipped what, which files churned most, whether test coverage kept pace, and how this period compares to the prior one. ## Quick Start Ask the assistant to run a weekly retro analyzing the last 7 days of commits on the main branch.

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 base branch, computes commit, LOC, session, and test metrics, and produces a formatted report with a per-author leaderboard.

How to compare this sprint's commits against the previous period?

Use the compare mode with an optional window, for example compare 14d. The skill analyzes the current window and the prior same-length window side by side so you can see trends in velocity, test ratio, and commit patterns.

Can I run a retrospective across multiple repositories?

Yes, the global mode runs a cross-project retro across all AI coding tools without requiring you to be inside a git repository. Pass an optional window like 14d to control the analysis period.

Does the retro skill work with GitLab as well as GitHub?

Yes, it detects the hosting platform from the git remote URL and uses gh or glab CLI commands accordingly. If neither CLI is available, it falls back to git-native commands to determine the base branch.

What metrics does a git-based engineering retro include?

The report covers commits, contributors, PRs merged, insertions and deletions, test LOC ratio, active days, detected work sessions, commit type breakdown, file churn hotspots, and PR size distribution. Optional rows cover backlog health and skill usage when those files exist.