Description

View formatted commit history, author stats, and commit frequency patterns. Use when reviewing logs, comparing contributions, or generating repo reports.

README (SKILL.md)

GitLog

Name: Gitlog
Author: ckchzh

GitLog v2.0.0 — a developer toolkit for managing commit history and log analysis from the command line. Log checks, validations, changelog generations, lint results, diffs, and more. Each entry is timestamped and persisted locally. Works entirely offline — your data never leaves your machine.

Why GitLog?

Works entirely offline — your data never leaves your machine
Simple command-line interface with no GUI dependency
Export to JSON, CSV, or plain text at any time for sharing or archival
Automatic activity history logging across all commands
Each domain command doubles as both a logger and a viewer

Commands

Domain Commands

Each domain command works in two modes: log mode (with arguments) saves a timestamped entry, view mode (no arguments) shows the 20 most recent entries.

Command	Description
`gitlog check \x3Cinput>`	Log a check operation such as verifying commit signatures, author consistency, or branch protection compliance. Track verification outcomes across releases and branches.
`gitlog validate \x3Cinput>`	Log a validation entry for commit message format checks, conventional commit compliance, or PR title standards. Record pass/fail outcomes and specific violations found.
`gitlog generate \x3Cinput>`	Log a generation task for changelog creation, release notes drafting, or commit summary generation. Track what was generated, the commit range covered, and contributor counts.
`gitlog format \x3Cinput>`	Log a formatting operation for reformatting log output, adjusting date formats, or restructuring commit displays. Record the format changes applied and the resulting output style.
`gitlog lint \x3Cinput>`	Log a lint result identifying commits with missing scopes, non-standard prefixes, or overly long subject lines. Useful for enforcing consistent commit message quality across teams.
`gitlog explain \x3Cinput>`	Log an explanation entry documenting why specific commits were made, architectural decisions behind changes, or context for complex merges. Build an annotated history.
`gitlog convert \x3Cinput>`	Log a conversion task for transforming log formats between representations such as markdown changelogs, HTML release pages, or RSS feeds. Record source and target formats.
`gitlog template \x3Cinput>`	Log a template operation for creating commit message templates, PR description templates, or changelog section templates. Track template versions and adoption.
`gitlog diff \x3Cinput>`	Log a diff result comparing branches, tags, or time ranges. Record commits ahead/behind, divergence points, and merge conflict potential between branches.
`gitlog preview \x3Cinput>`	Log a preview entry for reviewing staged commits, upcoming release contents, or draft changelogs before publishing. Useful for pre-release audits.
`gitlog fix \x3Cinput>`	Log a fix operation for commit message rewrites, author corrections, or history cleanup. Track what was fixed, the method used (amend, rebase, filter-branch), and the scope of changes.
`gitlog report \x3Cinput>`	Log a report entry for commit frequency analysis, contributor statistics, or release cadence summaries. Capture key metrics and trends from repository history.

Utility Commands

Command	Description
`gitlog stats`	Show summary statistics across all log files, including entry counts per category and total data size on disk.
`gitlog export \x3Cfmt>`	Export all data to a file in the specified format. Supported formats: `json`, `csv`, `txt`. Output is saved to the data directory.
`gitlog search \x3Cterm>`	Search all log entries for a term using case-insensitive matching. Results are grouped by log category for easy scanning.
`gitlog recent`	Show the 20 most recent entries from the unified activity log, giving a quick overview of recent work across all commands.
`gitlog status`	Health check showing version, data directory path, total entry count, disk usage, and last activity timestamp.
`gitlog help`	Show the built-in help message listing all available commands and usage information.
`gitlog version`	Print the current version (v2.0.0).

Data Storage

All data is stored locally at ~/.local/share/gitlog/. Each domain command writes to its own log file (e.g., check.log, lint.log). A unified history.log tracks all actions across commands. Use export to back up your data at any time.

Requirements

Bash (4.0+)
No external dependencies — pure shell script
No network access required

When to Use

Verifying commit message compliance and signature validity across releases and pull requests
Generating changelogs and release notes from commit history with contributor attribution
Linting commit messages to enforce conventional commit standards across the team
Comparing branch histories and tracking divergence for merge planning and conflict prevention
Building a searchable archive of commit explanations, fixes, and format conversion records

Examples

# Log a check operation
gitlog check "Verified all 47 commits in v2.0 release are GPG-signed by authorized authors"

# Generate a changelog entry
gitlog generate "v2.0.0 changelog — 47 commits, 12 contributors, 3 breaking changes"

# Validate commit messages
gitlog validate "All 23 commits follow conventional format: feat(scope): message"

# Log a lint result
gitlog lint "Found 3 commits with missing scope in message, 1 with subject over 72 chars"

# Record a diff comparison
gitlog diff "main..feature-auth: 23 commits ahead, 5 behind, no merge conflicts detected"

# View all statistics
gitlog stats

# Export everything to CSV
gitlog export csv

# Search entries mentioning release
gitlog search release

# Check recent activity
gitlog recent

# Health check
gitlog status

Powered by BytesAgain | bytesagain.com | [email protected]

Usage Guidance

This skill appears coherent and local-only. Before installing or running: (1) inspect the included scripts (scripts/script.sh) yourself — the agent will execute that code; (2) be aware it will create and write files under ~/.local/share/gitlog (history.log and per-command .log files); (3) run it in a sandbox or test account if you want to confirm behavior; and (4) when using the search command, avoid passing untrusted input that may be interpreted by grep in unexpected ways. No network access or credentials are requested by the skill.

Capability Analysis

Type: OpenClaw Skill Name: gitlog Version: 2.0.0 The GitLog skill is a simple shell-based logging utility designed to record and view timestamped entries of developer activities in a local directory (~/.local/share/gitlog/). Analysis of scripts/script.sh and SKILL.md shows no evidence of network activity, data exfiltration, or unauthorized file access; the tool operates entirely offline as stated and lacks any high-risk execution patterns or obfuscation.

Capability Assessment

✓ Purpose & Capability

Name/description match the included shell implementation: the script provides logging, searching, export, and status commands operating on repository-related text entries. There are no unrelated credentials, binaries, or services requested.

✓ Instruction Scope

SKILL.md instructs local CLI usage and storage in ~/.local/share/gitlog; the script implements exactly those behaviors. Instructions do not request reading other system config, secrets, or network endpoints.

ℹ Install Mechanism

No install spec (instruction-only) which is low-risk. A shell script is included in the bundle; the platform/agent will need to invoke that script directly. This is expected but means the agent will execute provided code if it runs the skill.

✓ Credentials

The skill requests no environment variables or credentials. It uses HOME implicitly to store data under ~/.local/share/gitlog, which is proportional for a local logging tool.

✓ Persistence & Privilege

always:false and the skill only writes its own files under the user's home directory. It does not modify other skills or system-wide agent settings.

Version History

v2.0.0

Domain-specific upgrade

Metadata

Slug gitlog

Version 2.0.0

License MIT-0

All-time Installs 2

Active Installs 2

Total Versions 1

Frequently Asked Questions

What is Gitlog?

View formatted commit history, author stats, and commit frequency patterns. Use when reviewing logs, comparing contributions, or generating repo reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 200 downloads so far.

How do I install Gitlog?

Run "/install gitlog" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gitlog free?

Yes, Gitlog is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gitlog support?

Gitlog is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gitlog?

It is built and maintained by BytesAgain2 (@ckchzh); the current version is v2.0.0.

More Skills

Gitlog