Git Stats

Analyze git repository statistics including contributor rankings, lines of code by language, commit frequency by day/hour, monthly activity trends, and file...

Security Scan

The skill's code and instructions match its stated purpose (local git repository statistics) and do not request unrelated credentials or network access.

Purpose & Capability

Name/description match the included script: it runs git commands and reads tracked files to compute contributor rankings, LOC, activity, and trends. Minor inconsistency: registry metadata listed 'Required binaries: none' but SKILL.md correctly documents that the git CLI and Python 3.8+ are required.

Instruction Scope

SKILL.md instructs the agent to run the included script against a local repo and offers relevant flags (--json, --no-loc, --since, --until, --branch). The script only reads git metadata and tracked files; it does not access unrelated system files or external endpoints.

Install Mechanism

No install spec (instruction-only with a bundled script). Nothing is downloaded or written to disk by an installer step.

Credentials

The skill requests no environment variables or credentials. The script does not read secrets from env vars or require unrelated credentials.

Persistence & Privilege

always is false and the skill does not modify agent/system configuration or other skills. It requires explicit invocation to run (normal behavior).

Assessment

This skill appears to do exactly what it says: analyze local git repositories. Before installing or running it, note that: - It runs 'git' commands and reads all tracked files in the repository (including file contents when counting LOC). Do not run it on repos containing secrets you don't want printed or exported. - The SKILL.md mentions required binaries (git and Python 3.8+); ensure those are present. The registry metadata omitted that requirement — this is a minor inconsistency but explainable. - The script prints contributor names/emails and repository file contents counts; if you plan to share output (JSON or text), sanitize sensitive data first. - For very large repos, use the --no-loc flag to skip line counting (much faster). - The package contains the full script (scripts/git_stats.py); you can review the code locally before running to confirm there is no network I/O or unexpected behavior (the included script uses subprocess.run for git and local file reads only). If you need additional assurance, run the script in an isolated environment (e.g., container) on a non-sensitive repo first.

Analyze any local git repository for contributor rankings, LOC by language, commit activity patterns, and monthly trends.

Quick Start

# Analyze current repo
python3 scripts/git_stats.py

# Analyze a specific repo
python3 scripts/git_stats.py /path/to/repo

# JSON output for further processing
python3 scripts/git_stats.py --json

# Filter by date range
python3 scripts/git_stats.py --since 2025-01-01 --until 2025-12-31

# Specific branch
python3 scripts/git_stats.py --branch main

# Skip LOC counting for faster results
python3 scripts/git_stats.py --no-loc

Output Sections

• Top Contributors — ranked by commit count with email
• Lines of Code — total files/lines, broken down by extension
• File Types — file count by extension
• Activity by Day — which days of the week get the most commits
• Activity by Hour — peak coding hours
• Monthly Trend — commit volume over the last 12 months (configurable with --months)

Options

Flag	Description
--branch	Analyze a specific branch
--since	Only include commits after this date
--until	Only include commits before this date
--months N	Monthly trend window (default: 12)
--json	Output as JSON for programmatic use
--no-loc	Skip line counting (much faster on large repos)

Dependencies

• git CLI (must be on PATH)
• Python 3.8+ (stdlib only, no pip packages needed)