weeklyRetro

Summarize git activity into weekly per-person metrics for retrospectives.

1|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/joi-fairshare/agentic-workflow --skill weeklyretro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weeklyRetro
Source: https://github.com/joi-fairshare/agentic-workflow/tree/main/skills/weeklyRetro
Command: npx skills add https://github.com/joi-fairshare/agentic-workflow --skill weeklyretro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Weekly retrospectives rarely capture the full git history context, so teams struggle to quantify individual contributions, streaks, and current test health without manual log parsing and report writing.

Core Features & Use Cases

  • Per-person analytics: aggregates commits, lines added/removed, files, top directories, and conventional commit types for each contributor.
  • Shipping streaks & testing: tracks consecutive commit days, longest/current streak, and runs the project test suite while diffing newly added tests.
  • Actionable insights: highlights high-churn files, ownership gaps, and generates a structured markdown report in ~/.agentic-workflow/<repo>/retros/ to guide next-week focus.

Quick Start

Run /weeklyRetro to analyze the past week's commits and surface shipping streaks.

Frequently Asked Questions about weeklyRetro

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a weekly retrospective report from git history?

To generate a weekly retrospective report from git history, run /weeklyRetro to aggregate per-person commits, lines changed, streaks, and test health into a structured markdown file saved in the repository retros directory.

Can I track individual contributor metrics like shipping streaks from git logs?

Yes, you can track individual contributor metrics from git logs by analyzing consecutive commit days to compute current and longest shipping streaks, alongside per-person commits and lines changed for the selected period.

How do I quantify test health for a team's weekly git activity?

To quantify test health for weekly git activity, the system executes the project test suite and diffs newly added tests against the baseline, surfacing pass rates and new test coverage within the retrospective report.

What is the best way to identify high-churn files and ownership gaps in our repositories?

The best way to identify high-churn files and ownership gaps is to aggregate git activity per contributor, highlighting which files change most frequently and which directories lack clear ownership to guide next-week team focus.

Does weekly git reporting work with conventional commit types for team insights?

Yes, weekly git reporting works with conventional commit types by parsing commit messages to categorize each contributor's activity, providing structured team insights for the selected retrospective period.

How do I filter git metrics for specific team members during a retrospective?

To filter git metrics for specific team members during a retrospective, apply the analysis to selected contributors, computing individual commits, top directories, and shipping streaks only for those filtered users.