gstack-openclaw-retro

Generates weekly engineering retrospectives from git commit history with team metrics and trend tracking.

Updated May 15, 2026
One-click install
npx skills add https://github.com/tgmarinho/canetaco --skill gstack-openclaw-retro-tgmarinho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-openclaw-retro
Source: https://github.com/tgmarinho/canetaco/tree/main/.claude/skills/gstack/openclaw/skills/gstack-openclaw-retro
Command: npx skills add https://github.com/tgmarinho/canetaco --skill gstack-openclaw-retro-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams lack visibility into how they actually work: who shipped what, when coding happens, whether test coverage is improving, and whether fix-heavy weeks signal quality problems. Manually compiling this from git history is tedious and rarely done consistently. ## Core Features & Use Cases - Automated Git Analysis: Runs a battery of git log queries to compute commits, LOC, test ratios, PR sizes, hotspots, session patterns, and hourly commit distributions over a configurable window (24h, 7d, 14d, 30d). - Team-Aware Breakdowns: Identifies the current user via git config, then produces per-contributor analysis with commit mix, focus areas, praise anchored in actual commits, and data-backed growth opportunities. - Persistent Trend Tracking: Saves each retro as JSON in a memory/ directory and compares against prior runs to show week-over-week deltas in test ratio, velocity, and fix ratio, plus team and personal shipping streaks. - Use Case: A tech lead runs the retro every Friday to get a Telegram-formatted summary of the week's shipping velocity, code quality signals, and per-teammate highlights for the team channel. ## Quick Start Ask the assistant to run the weekly engineering retro for the last 7 days of this repository.

Frequently Asked Questions about gstack-openclaw-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 in a git repository and it executes git log queries against origin/main for the chosen window, computing commits, LOC, test ratios, sessions, and hotspots. It then writes a formatted narrative with per-author breakdowns and saves a JSON snapshot for trend tracking.

How to analyze team commit patterns and coding sessions with git?

The skill detects work sessions using a 45-minute gap threshold between consecutive commits and classifies them as deep, medium, or micro. It also builds an hourly commit histogram in local time to reveal peak hours, dead zones, and late-night coding clusters.

Can I compare this week's engineering metrics against last week?

Yes, use the compare argument to run the retro for the current window and the prior same-length window side by side. It also automatically loads the most recent saved retro from the memory/ directory to show deltas in test ratio, sessions, and fix ratio.

What time windows does the git retrospective support?

The default window is the last 7 days, with options for 24 hours, 14 days, and 30 days. Day-based windows are aligned to local midnight, and all times are reported in the user's local timezone.

Why does the retro report BLOCKED status?

The skill reports BLOCKED when it is not run inside a git repository or when there are no commits in the selected window. Ensure you are in a git repo with commits on origin/main within the chosen time range.