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.