# Changelog

> Generate or update changelog content from git history and Conventional Commits. Use for release notes, version summaries, and tag preparation.

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

---


# Changelog

Generate release notes from repository changes.

## Workflow

1. Identify the previous tag with `git describe --tags --abbrev=0` when available.
2. Read commits since the previous tag, or since the branch point if no tag exists.
3. Group Conventional Commit types: `feat`, `fix`, `perf`, `refactor`, `docs`, `test`, `build`, `ci`, `chore`, and breaking changes.
4. Propose the version bump when asked to release.
5. Update `CHANGELOG.md` only when the user asks for file edits.
6. Do not create tags or GitHub releases unless explicitly requested.

## Output

Use:

- `Added`
- `Changed`
- `Fixed`
- `Removed`
- `Security`
- `Internal`

Mention the commit range used.