gstack-openclaw-retro

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

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-openclaw-retro-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-openclaw-retro
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/openclaw/skills/gstack-openclaw-retro
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-openclaw-retro-sanjanb

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-to-feature ratios signal quality problems. Manually compiling this from git history every week is tedious and inconsistent. ## Core Features & Use Cases - Automated Git Analysis: Runs a battery of git log commands to compute commits, LOC, test ratios, PR sizes, hotspots, session patterns, and commit-type breakdowns over configurable windows (24h, 7d, 14d, 30d). - Team-Aware Reporting: Identifies the current user via git config, then produces per-contributor analysis with praise and growth areas anchored in actual commits, plus streak tracking and focus scores. - Persistent Trend Tracking: Saves JSON snapshots to a memory/ directory and compares against prior retros to show week-over-week deltas in test ratio, velocity, and fix ratio. - Use Case: A team lead asks "what shipped this week?" and receives a Telegram-formatted retro with a tweetable summary, per-person breakdowns, top wins, and three actionable improvements. ## Quick Start Ask the agent to run a weekly engineering retrospective 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?

Invoke the skill with a time window argument such as 7d, 14d, or 30d. It runs git log queries against origin/main to compute commits, LOC, test ratios, and session patterns, then writes a formatted narrative report.

How to compare this week's engineering metrics against last week?

Pass the compare argument to run the retro for both the current window and the prior same-length window. The output presents side-by-side metrics with arrows showing improvement or regression.

Does the retrospective support teams with multiple contributors?

Yes, it identifies the current user via git config and analyzes every contributor separately. Each teammate gets commits, LOC, focus areas, praise anchored in specific commits, and one data-backed growth opportunity.

What git data does the retrospective analyze?

It analyzes commit timestamps, authors, insertions and deletions, conventional commit prefixes, file-level churn hotspots, PR numbers from commit messages, and test file changes. It also detects work sessions using a 45-minute gap threshold.

Why does the retrospective show no trend comparison?

Trend comparison requires a prior retro snapshot saved in the memory directory as a JSON file. On the first run it records baseline metrics and notes that trends appear starting with the next retro.

What are the limitations of git-based engineering retrospectives?

The analysis only covers commits merged to origin/main, so unmerged branches and non-code work are invisible. It also requires being run inside a git repository with commits in the selected window, otherwise it reports BLOCKED.