add-changelog-entry

name	add-changelog-entry
description	Use when you've made code changes and need to add a changelog entry. Analyzes git diffs to create changie fragment YAML files in the correct format for this project.

*CRITICAL* Add the following steps to your Todo list using TodoWrite:

1. Analyze recent code changes using git diff
2. Determine the appropriate changelog kind(s) and draft entry body text
3. Confirm entries with the user before writing
4. Write changie fragment YAML files to .changes/unreleased/
5. Verify the created files are valid

Overview

This skill creates changelog entries for the shelf project using changie. Instead of running the interactive changie new command, it writes fragment YAML files directly to .changes/unreleased/.

Step-by-Step Process

1. Analyze recent code changes

Examine what has changed to determine what changelog entries are needed. Run:

# Check for staged changes first, fall back to unstaged, then recent commits
git --no-pager diff --cached --stat
git --no-pager diff --stat
git --no-pager log --oneline -5

Read the actual diffs to understand the nature of the changes:

git --no-pager diff --cached  # staged changes
git --no-pager diff           # unstaged changes

If no local changes are found, check the most recent commit(s) that don't have changelog entries yet.

2. Determine changelog kind(s) and draft entries

Classify each distinct change into one of the following kinds (defined in .changie.yaml):