change-writer
Generates clean, human-readable changelogs and release notes from git commits and file changes. Use when preparing for a release or summarizing recent work.
When & Why to Use This Skill
The Change Writer skill for Claude automates the creation of professional, human-readable changelogs and release notes by analyzing git commit history and repository changes. It streamlines the software release process by intelligently categorizing updates into features, bug fixes, and performance improvements, ensuring clear and structured communication for development teams and stakeholders.
Use Cases
- Automated Release Notes: Generate comprehensive release notes for GitHub, GitLab, or internal platforms by summarizing all commits since the last version tag.
- Changelog Maintenance: Automatically update and format the CHANGELOG.md file in a repository to maintain an accurate and readable history of project evolution.
- Sprint Summarization: Create concise summaries of weekly development work to share with project managers or stakeholders during sync meetings.
- Onboarding & Context: Help new team members understand recent architectural changes and feature additions by providing a structured overview of recent repository activity.
| name | change-writer |
|---|---|
| description | Generates clean, human-readable changelogs and release notes from git commits and file changes. Use when preparing for a release or summarizing recent work. |
Change Writer Skill
This skill analyzes recent changes in the repository to generate structured changelogs. It categorizes changes into Features, Fixes, and Refactors.
Instructions
- Analyze History: Run the git log command to see recent changes.
- Identify Impact: Look at changed files to understand the scope (e.g., UI, logic, infrastructure).
- Draft Notes: Group changes by type (Feat, Fix, Chore, Docs).
- Format: Output in Markdown format compatible with
CHANGELOG.mdor GitHub Releases.
Categories
- 🚀 Features: New functionality.
- 🐛 Bug Fixes: Resolving issues.
- ⚡ Performance: Speed optimizations.
- 🧹 Chores: Internal tasks, dependency updates.
- 📝 Documentation: Changes to docs.
Example Output
## [1.2.0] - 2025-12-27
### 🚀 Features
- Added `Zustand` store for global theme management.
- Implemented `api-expert` skill for better backend integration.
### 🐛 Bug Fixes
- Fixed keyboard avoiding view overlap on Android.
- Resolved race condition in auth flow.
### 🧹 Chores
- Updated `expo` to SDK 54.
- Cleaned up unused assets.
Run scripts/get-changes.sh to see a summary of unstaged changes.