# Changelog Generator

> Generate customer-facing changelog entries from git commits and PR diffs.

- Skill: `devton/changelog-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add devton/changelog-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/devton/changelog-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: devton (https://skillmd.com/u/devton)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/devton/changelog-generator

---


## agentic-workflows-blueprint.workflow.changelog-generator

### Goal

Analyze session git commits and generate user-facing release notes categorized by features, fixes, and improvements.

### Scope

- **Applies to**: Post-implementation delivery and PR completion.
- **Does not cover**: Internal dev notes or technical refactor logs (keep those in code comments).

### Triggers

- "/changelog-generator"
- "Generate user changelog"
- "Summarize release notes"

### Inputs

- `baseBranch`: Target integration branch (`main`, `develop`).
- `commits`: Git commits in session.

### Invariants

1. **User Perspective**: Write for end users, not backend implementation details.
2. **Clear Categorization**: Group into Features, Fixes, and Improvements.

### Procedure

1. Run `git log` against `baseBranch` to inspect session commits.
2. Filter and categorize user-visible changes.
3. Transform technical language into clear benefit-driven descriptions.
4. Output changelog section into `walkthrough.md`.

### Outputs

- User-facing Changelog entry in `walkthrough.md`.

### Review gate

- Changelog reflects user-facing impact accurately.

### References

- `../../SKILL.md`
- `../radioactive/SKILL.md`
- `../changelog/SKILL.md`
- [Interactive HTML View](./README.html)