get-commits

Original：🇺🇸 English

Translated

1 scripts

Extract and parse local git commit history into structured JSON format with custom tags ([Why], [What], [Impact]). Use when generating changelogs, creating PR summaries, updating CHANGELOG.md files, or analyzing recent code changes. Parses conventional commits, extracts technical details and business impact, and returns flat JSON to save context tokens and reduce hallucinations during documentation generation.

2installs

Sourcearoldolanderos/skills

Added on2026-02-17

NPX Install

npx skill4agent add aroldolanderos/skills get-commits

SKILL.md Content

View Translation Comparison →

Git Changelog Parser

Parse local git commit history into clean, structured JSON. Extracts conventional commit metadata, custom tags ([Why], [What], [Impact]), and returns a token-efficient flat structure ready for documentation workflows.

Quick Start

bash

python3 scripts/get_commits.py 20

Returns JSON with last 20 commits:

json

[
  {
    "hash": "abc1234",
    "date": "2026-02-09",
    "type": "feat",
    "scope": "auth",
    "title": "Add JWT authentication",
    "what": "Implemented JWT tokens with refresh mechanism",
    "impact": "Breaking change: auth endpoints require tokens"
  }
]

Use in your workflow

Changelog: Run script, extract [What] fields, format as Markdown
PR Summary: Run script, extract [Impact] fields, create executive summary
Change Analysis: Run script, filter by type/scope, generate reports

Commit Message Format

The script expects commits following this structure:

feat(scope): Brief description

[Why] Reason for this change
[What] Technical implementation details
[Impact] Business impact or breaking changes

First line:
```
type(scope): title
```
or
```
type: title
```
Tags on separate lines:
```
[Why]: ...
```
,
```
[What]: ...
```
,
```
[Impact]: ...
```
All tags are optional; missing tags return empty strings
Merge commits are filtered out automatically

Script Parameters