changelog - SKILL.md Agent Skill

name: changelog description: Maintains CHANGELOG.md in the project root using git commit history. Use when the user invokes /changelog, asks to "update the changelog", "generate a changelog", or wants to record what changed before merging a branch. Creates the file from scratch if it doesn't exist (all commits grouped by date); otherwise appends only commits newer than the last recorded date.

Changelog Skill

Workflow

Run the script from the project root:

python3 <skill-dir>/scripts/changelog.py

Where <skill-dir> is the directory containing this skill. Claude Code exposes the skill path — use it directly.

The script handles both cases automatically:
- No CHANGELOG.md: reads full git history, writes the file with all dates
- CHANGELOG.md exists: finds the newest ## YYYY-MM-DD heading, fetches commits after that date, prepends new sections
Review the output, edit bullet wording if needed, then commit CHANGELOG.md as part of the merge commit.

Format

# Changelog

## 2026-03-31

- Add responsive design to layout and CSS
- Add Vitest test suite for components and routes

## 2026-03-30

- Initial project scaffold

One # Changelog title at the top
Date headings as ## YYYY-MM-DD, newest first
Each commit is one bullet; wording may be cleaned up manually after generation

Notes

Run from the project root (same directory as .git/)
Commit subjects come directly from git log; clean them up manually if needed
The script is idempotent: re-running when nothing is new prints a message and exits without modifying the file