# Changelog Gen

> Generates a categorized changelog skeleton from conventional commits since a tag or ref — Added/Changed/Fixed/Documentation/Internal sections with scope annotations preserved. Deterministic; the agent writes prose, this provides the honest skeleton from git history itself.

- Skill: `trac3r00/changelog-gen` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add trac3r00/changelog-gen`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trac3r00/changelog-gen/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: trac3r00 (https://skillmd.com/u/trac3r00)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/trac3r00/changelog-gen

---


# Changelog Gen

Release notes from the only honest source: the commit history itself.

## Commands

```bash
python3 scripts/changelog_gen.py                          # since last tag
python3 scripts/changelog_gen.py --since-tag v1.2.0
python3 scripts/changelog_gen.py --since HEAD~20 --json
python3 scripts/changelog_gen.py --out CHANGELOG.md
```

## Sections (conventional-commit mapping)

| Type | Section |
|---|---|
| `feat` | Added |
| `fix`, `revert` | Fixed |
| `refactor`, `perf`, `style` | Changed |
| `docs` | Documentation |
| `test`, `chore`, `build`, `ci` | Internal |

Scope annotations preserved: `feat(api): add tokens` -> "add tokens (api)".
Non-conventional commits land in Other — visible, not silently dropped.

## Pairs with

`git-master` (the history this reads), `repo-audit` (the repo hygiene gate
that would flag a missing changelog workflow).