summarize-progress

Aggregate git commit history into a Markdown report for a specified time range.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill summarize-progress-mattbobambrose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: summarize-progress
Source: https://github.com/mattbobambrose/mattbobambrose-claude-skills/tree/main/plugins/summarize-progress/skills/summarize-progress
Command: npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill summarize-progress-mattbobambrose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a concise, human-friendly summary of what a developer accomplished over a specific time period by automatically analyzing git commit history, so users can quickly understand progress without manually inspecting logs and diffs.

Core Features & Use Cases

  • Scope selection: Offer summaries for the current project or for all local git repositories under a parent directory.
  • Flexible time ranges: Resolve natural phrases (today, yesterday, last week, specific dates, or relative phrases) to concrete --after/--before ranges and collect commits for that period.
  • Detailed aggregation: Count commits, unique files changed, lines added and removed, and capture per-repo and aggregate totals.
  • Highlights and breakdowns: Produce concise thematic highlights derived from commit messages and diffs, plus optional day-by-day activity for multi-day ranges.
  • Persisted report: Write a Markdown report to reports/daily/YYYY-MM-DD.md and display it in the conversation, with a tailored motivational closing message based on activity level.

Quick Start

Summarize my commits for last week across all local git repositories and write a markdown report to reports/daily/.

Frequently Asked Questions about summarize-progress

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

FAQPage Schema
How do I generate a progress report from my git commit history?

You can generate a git activity summary by analyzing commit history for a specific time range, aggregating commits, files changed, and lines added or removed, then outputting a Markdown report to reports/daily/YYYY-MM-DD.md.

Can I summarize git commits across multiple local repositories at once?

Yes, you can summarize git commits across multiple local repositories by scanning up to three levels of local git repositories under a parent directory, aggregating per-repo and total activity into a single Markdown report.

What natural time phrases can I use to filter my git activity summary?

You can use natural time phrases like today, yesterday, last week, last month, or specific dates to filter your git activity summary. The tool resolves these phrases into concrete --after and --before timestamps to collect commits.

Does the git summary report include motivational feedback based on activity level?

Yes, the git summary report includes a tailored motivational closing message based on your activity level. It also produces concise thematic highlights derived from commit messages and diffs to help you understand progress.

Do I need to install any extra dependencies to analyze git logs and generate a markdown report?

No extra dependencies are required to analyze git logs and generate a markdown report. The Skill operates independently to filter commits to the current git user and compute the resulting activity summary.