Update CHANGELOG
SkillDocs & knowledgeGenerate and insert a new CHANGELOG.md version entry from git changes between main and the current branch. Use this skill whenever the user wants to update CHANGELOG.md, write release notes, document what changed since branching from main, or add a new version entry. Trigger on phrases like "update changelog", "add changelog entry", "document changes".
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Update CHANGELOG skill
What this skill tells your AI
The instructions your AI receives, as published by kajitiluna/erd-designer in .claude/skills/update-changelog/SKILL.md and read by ahel’s review.
Generate a user-facing CHANGELOG.md entry from the git changes between main and the current branch.
Step 1: Gather information
date +%Y%m%d # today's date → version number
git log main..HEAD --oneline # commits on this branch
git diff main..HEAD # full diff for analysis
Step 2: Identify user-facing changes
Analyze the diff from the user's perspective — what they can do differently, not how the code changed.
Include:
- New features, UI options, menu items, commands, or keyboard shortcuts
- Behavior changes visible to the user (defaults, layout, export output, etc.)
- Bug fixes that affected users (what broke, in what scenario)
- New file format support or protocol options
Exclude:
- Internal refactoring, code cleanup, or abstraction changes
- Test additions or fixes
- Dependency version bumps (unless they fix a user-visible bug)
- Build/CI configuration changes
- Developer tooling (guidelines, linter config, etc.)
If there are no user-facing changes, state that clearly instead of inventing entries.
Step 3: Generate the entry
Version format: 0.{yyyyMMdd} using today's date from Step 1.
Follow the existing CHANGELOG.md format exactly:
## [0.yyyyMMdd] - yyyy-MM-dd
### Added
- **Feature Title**:
One to three sentences describing what was added, from the user's perspective.
What can users do now that they couldn't before?
### Changed
- **Change Title**:
What changed and how it affects users.
### Fixed
- **Fix Title**:
What was broken, in what scenario, and what is now correct.
Formatting rules:
- Only include sections (
### Added,### Changed,### Fixed) that have content - Bold title on the bullet line, followed by a colon
- Body indented with two spaces, separated from the title line by a blank line
- English only, concise, present tense ("Users can now...", "The dialog now shows...")
- Group multiple related sub-points under one bullet using indented sub-bullets if needed
Step 4: Present and confirm
Show the generated entry as a markdown preview. Then ask the user whether to:
- Insert it into CHANGELOG.md (place just below the
## [Unreleased]line) - Revise the content first
Do not write to the file until the user confirms.
Signals
- GitHub stars
- 21
- Forks
- 6
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
update-changelog-kajitiluna- Source
- github.com/kajitiluna/erd-designer