Git Changelog

A development skill that reads git log output from a repository, parses conventional commit messages, groups them by category, and produces a clean Markdown changelog.

83Trust Medium
by hermeshub-coredevelopmentintermediatev1.1.3updated Feb 20, 2026
4.1kTotal Runs
90.0%Success Rate
1.6kInstalls
83Trust Score

Tags

#git#changelog#release-notes#conventional-commits#devtools

Required Tools

bashfile_read

Inputs

NameTypeDescriptionReq
repo_pathfilePath to the git repository root.yes
sincetextStart date or tag (e.g. "2025-01-01" or "v1.2.0"). Defaults to last tag.--
untiltextEnd date or "HEAD". Defaults to HEAD.--
branchtextBranch to read history from. Defaults to current branch.--

Outputs

NameTypeDescriptionReq
changelogtextMarkdown-formatted changelog grouped by commit type.yes

Compatible Skills

SKILL.md

---
name: git-changelog
description: Generate structured changelogs from git commit history using conventional commits.
---

# Git Changelog

Generate professional changelogs from git history.

## Quick Start

### Basic Changelog

```bash
# Generate changelog since last tag
git log --pretty=format:"%s" $(git describe --tags --abbrev=0)..HEAD

# Group by conventional commits
git log --pretty=format:"%s" | grep -E "^(feat|fix|chore|docs|style|refactor|test|build|ci|perf):"
```

### Using git-chglog

```bash
# Install git-chglog
go install github.com/git-chglog/git-chglog/cmd/git-chglog@latest

# Generate changelog
git-chglog -o CHANGELOG.md

# For specific tag range
git-chglog v1.0.0..v1.1.0 -o CHANGELOG.md
```

## Conventional Commit Types

| Type | Description |
|------|-------------|
| feat | New features |
| fix | Bug fixes |
| docs | Documentation |
| style | Formatting |
| refactor | Code restructuring |
| perf | Performance |
| test | Tests |
| build | Build system |
| ci | CI/CD |
| chore | Maintenance |

## Output Format

```markdown
## [1.2.0] - 2026-03-15

### Features
- Add user authentication
- Implement dark mode

### Bug Fixes
- Fix login redirect issue
- Correct timezone handling

### Documentation
- Update API reference
```

## Example Commands

```bash
# Since specific date
git log --since="2026-01-01" --pretty=format:"%h %s"

# By author
git log --author="John" --pretty=format:"%s"

# With stats
git log --stat --oneline
```

## Integration

Works with:
- GitHub Releases
- GitLab Releases
- npm version
- semantic-release