What it does

Git Stats is a comprehensive repository mining tool that transforms raw git history into a deep analytical report. It automates the complex process of parsing git logs, calculating contribution metrics, and identifying repository hotspots. Instead of manually running multiple terminal commands, the skill scrapes high-fidelity data to generate a centralized GIT_STATS.md report.

Why use this skill

Manually auditing a repository's health or contributor activity is time-consuming and prone to human error. This skill provides values that standard git commands don't show natively, such as commit streaks, language distribution by file count, and activity heatmaps by hour or day of the week. It identifies "hot files" that change most frequently, helping developers pinpoint technical debt or areas requiring refactoring.

Supported tools

The skill utilizes standard git CLI tools combined with bash for data processing. It works on any local git repository regardless of the programming language or framework used.

Output

The skill produces a rich Markdown report featuring ASCII bar charts, formatted tables, and a high-level summary. It details top contributors, monthly activity trends, commit size averages, and peak productivity periods.