gather-github-stats

Collect and report GitHub repository statistics, including PR throughput, commit velocity,
contributor activity, and optionally lines-of-code metrics from a local archive.

Quick Start

# Full report — GitHub API + local archive
/gather-github-stats

# GitHub API only (skip local scan)
/gather-github-stats --github-only

# Local archive only (no GitHub API calls)
/gather-github-stats --local-only --local-path /Volumes/PRO-G40/Code/omni_home  # local-path-ok

# Use cached results (fast re-run)
/gather-github-stats --cached

# Write to custom output file
/gather-github-stats --output /tmp/my_stats.md

# Include LOC metrics (slow — scans every .py/.ts file)
/gather-github-stats --github-only --include-local-loc --local-path /Volumes/PRO-G40/Code  # local-path-ok

# Include private repos
/gather-github-stats --github-only --include-private

Arguments

Implementation

Invoke gather_stats.py from the skill directory:

python ${CLAUDE_PLUGIN_ROOT}/skills/gather-github-stats/gather_stats.py [args]

Output Format

The skill writes a Markdown report to --output (default ./stats_output.md) with sections:

1. Summary — total repos, PRs merged, commits in period
2. PR Throughput — open/merged/closed counts, avg time-to-merge
3. Commit Velocity — commits per day/week, top contributors
4. Contributor Activity — per-user PR and commit counts
5. LOC Metrics — total lines, language breakdown (when --include-local-loc)
6. Local Archive — discovered repos, branches, dirty status (when not --github-only)

Dependencies

• gh GitHub CLI (authenticated: gh auth status)
• git for local archive scan
• Python 3.12+ with uv