GitHub Stats Skill

A CLI tool and static dashboard generator for personal GitHub activity statistics. See what you shipped each month: commits, PRs, new repos, and lines of code.

What it does

• Summary table: monthly breakdown of commits (public + private), PRs opened, and repos created for a given year.
• Static dashboard: a self-contained HTML page with GitHub-style heatmap visualizations.
• Per-repo breakdown: additions, deletions, and final line counts for every repo you contributed to.

Install

git clone https://github.com/grapeot/github_stats_skill.git
cd github_stats_skill
uv venv
uv pip install -e '.[dev]'

Configure

cp .env.example .env
# edit .env and set GH_TOKEN to a GitHub personal access token
# scopes needed: repo (for private repos), read:org (optional)

Use

# Monthly summary table for the current year
github-stats summary

# Monthly summary for a specific year
github-stats summary --year 2026

# Generate a static HTML dashboard
github-stats dashboard --output site/index.html

# Per-repo breakdown with additions/deletions and final line counts
github-stats repos --year 2026

# All of the above in one command
github-stats all --year 2026 --output site/

How it works

The tool reads data entirely from the GitHub REST and GraphQL APIs—no cloning required for the summary and dashboard. For final line counts (the current state of each repo's codebase), it performs shallow git clone --depth 1 into a temporary directory and counts lines with cloc-equivalent logic, then cleans up.

License

MIT