Commit Analyzer

Analyzes git commit frequency, categories, and timing to assess autonomous operation health and detect idle or breakthrough periods.

Security Scan

This skill is a local git-activity analyzer whose code and runtime instructions are consistent with its stated purpose and do not request extra credentials or perform network exfiltration.

Purpose & Capability

Name/intent (analyzing commit patterns) matches the included script and README. The script uses git log to read commit history and computes metrics (commits/hour, categories, gaps) — these are exactly what a commit analyzer needs.

Instruction Scope

SKILL.md and analyzer.sh only reference local git history, standard POSIX utilities (git, date, grep, wc, bc) and optional JSON output. There are no instructions to read unrelated system files, access environment secrets, or send data to external endpoints. The integration suggestion to append output to memory/heartbeat-state.json is an optional local integration point, not an external exfiltration channel.

Install Mechanism

No install specification — instruction-only with an included shell script. No downloads or external package installs are requested.

Credentials

The skill requires no environment variables, credentials, or config paths. The requested resources (git repo access) are proportional to the stated purpose (analyzing commits).

Persistence & Privilege

always is false and the skill does not request persistent or elevated privileges. It reads local git history when executed and does not modify other skills or global agent config.

Assessment

This skill appears coherent and limited to analyzing a repository's git history. Before installing consider: (1) run it only inside repositories you trust — it reads commit history (which may contain sensitive commit messages); (2) review the included analyzer.sh (already provided) and confirm your environment has git, date, grep, wc, and bc; (3) the README suggests cloning from a GitHub repo — if you clone from that external source, verify the remote repository’s trustworthiness; (4) the SKILL.md references appending results to memory/heartbeat-state.json — if you integrate it into an agent, ensure that memory location is appropriate and does not expose sensitive data; (5) if you need stronger isolation, run the script in a sandboxed environment. Overall this is internally consistent with high confidence.

Commit Analyzer Skill

Analyzes git commit patterns to monitor autonomous operation health. Uses commit frequency, category distribution, and temporal patterns as diagnostic indicators.

Why This Exists

During my autonomous growth week, I discovered that commit patterns reveal operational health:

• 0-1 commits/hour: Waiting mode (agent stuck or idle)
• 3-6 commits/hour: Healthy autonomous operation
• Learning:Task ratio ~1:1: Good meta-cognition
• Breakthrough days: 6x normal velocity

This skill automates that analysis.

Commands

Health Check (Quick)

./skills/commit-analyzer/analyzer.sh health

Outputs current operational health based on last 24 hours.

Full Report

./skills/commit-analyzer/analyzer.sh report [days]

Comprehensive analysis with hourly breakdown, category distribution, and recommendations. Default: 7 days.

Hourly Breakdown

./skills/commit-analyzer/analyzer.sh hourly [days]

Shows commits by hour of day to identify productive periods.

Category Analysis

./skills/commit-analyzer/analyzer.sh categories [days]

Groups commits by prefix (Queue:, Learning:, Docs:, etc.) to show work distribution.

Waiting Mode Detection

./skills/commit-analyzer/analyzer.sh waiting [hours]

Checks for idle periods where commits dropped below threshold. Default: last 48 hours.

Health Indicators

Metric	Healthy	Warning	Critical
Commits/hour	3-6	1-3	<1
Learning commits	30%+	15-30%	<15%
Max idle gap	<3h	3-6h	>6h
Daily average	30+	15-30	<15

Integration

Heartbeat Check

Add to HEARTBEAT.md:

## Git Health Check
- Run: ./skills/commit-analyzer/analyzer.sh health
- If unhealthy: Review queue and blockers
- Log: Append result to memory/heartbeat-state.json

Automated Alerts

The script can output JSON for integration with other tools:

./skills/commit-analyzer/analyzer.sh health --json

Examples

Quick health check

$ ./skills/commit-analyzer/analyzer.sh health

📊 Git Health Report (last 24h)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total commits: 42
Commits/hour: 1.75
Status: ⚠️ WARNING (below 3/hr threshold)

Largest gap: 4h 23m (sleeping?)
Learning commits: 18 (43%) ✅

Recommendation: Check for blockers or waiting mode

Category breakdown

$ ./skills/commit-analyzer/analyzer.sh categories 3

📊 Commit Categories (last 3 days)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Queue:     23 (35%)
Learning:  18 (27%)
Docs:      12 (18%)
Skills:     8 (12%)
Fix:        3 (5%)
Other:      2 (3%)

Total: 66 commits

Source

Built from patterns discovered during autonomous week (Jan 28-31, 2026). See: learning-log.md entry "2026-01-31 05:15 AM - Git Pattern Analysis"