git-review

Analyze git commit history within a time range to generate a 7-dimension retrospective report.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/gmh5225/k-skills --skill git-review-gmh5225
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-review
Source: https://github.com/gmh5225/k-skills/tree/main/skills/productivity/git-review
Command: npx skills add https://github.com/gmh5225/k-skills --skill git-review-gmh5225

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually reviewing git commit history to summarize work progress is time-consuming, error-prone, and difficult to standardize for regular retrospectives or team reporting. Developers and engineering managers often spend excessive time compiling work done over a day, week, or custom time range, and struggle to identify patterns, gaps, or improvement opportunities in their commit habits.

Core Features & Use Cases

  • Flexible Time Range Input: Supports natural language time specifications like "yesterday", "last 3 days", "this week", or custom date ranges, automatically converting them to valid git log parameters.
  • 7-Dimension Structured Analysis: Generates a comprehensive report covering work summary, change type distribution, work rhythm, commit practice scoring, technical decision tracking, completion status checks, and actionable improvement suggestions.
  • Daily Notes Integration: Cross-references personal daily notes (if stored in the standard notes/daily_notes/ directory) to compare planned vs actual work, identifying uncompleted tasks or extra unplanned work.
  • Multi-Format Output: Produces a styled HTML report for easy viewing, and optionally converts it to PDF for sharing via tools like Feishu.
  • Use Case: Ideal for developers doing daily/weekly work reviews, engineering managers tracking team progress, and teams looking to standardize retrospective processes and improve commit quality.

Quick Start

Use the git-review skill to analyze all commits from yesterday in the current git repository and generate a work retrospective report.

Frequently Asked Questions about git-review

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

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

Generating a work retrospective from git commits involves analyzing the commit history within a specified time range to automate work summaries, track technical changes, and audit commit practices. This process eliminates manual review effort by producing a structured 7-dimension analysis report covering work rhythm and improvement suggestions.

Can I analyze git commits for a specific custom date range like last 3 days?

Yes, analyzing git commits for a custom date range is supported using natural language time specifications like "last 3 days", "yesterday", or "this week". The tool automatically converts these inputs into valid git log parameters to filter the commit history for the retrospective report.

How does the git commit analysis evaluate my commit practices and work rhythm?

The git commit analysis evaluates commit practices and work rhythm by applying a 7-dimension structured analysis framework. It scores commit practices, identifies technical decisions, tracks change type distribution, and checks completion status to provide actionable improvement suggestions.

Does the retrospective report support cross-referencing personal daily notes with git commits?

Yes, the retrospective report supports daily notes integration by cross-referencing personal notes stored in the standard `notes/daily_notes/` directory. This feature compares planned tasks against actual git commits to identify uncompleted tasks or extra unplanned work.

What output formats are available for the generated git work summary report?

The git work summary report produces a styled HTML output for easy viewing and optionally converts it to PDF format. This multi-format output allows for straightforward local review and sharing via collaboration tools like Feishu.

What's the best way to standardize weekly work progress reporting for an engineering team?

Standardizing weekly work progress reporting is best achieved by automating the extraction of commit history into a structured 7-dimension analysis report. This approach tracks team progress, audits commit quality, and generates consistent technical change summaries without manual compilation effort.