Changelog Generator

1---
2name: changelog-generator
3description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
4---
5 
6# Changelog Generator
7 
8This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
9 
10## When to Use This Skill
11 
12- Preparing release notes for a new version
13- Creating weekly or monthly product update summaries
14- Documenting changes for customers
15- Writing changelog entries for app store submissions
16- Generating update notifications
17- Creating internal release documentation
18- Maintaining a public changelog/product updates page
19 
20## What This Skill Does
21 
221. **Scans Git History**: Analyzes commits from a specific time period or between versions
232. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
243. **Translates Technical → User-Friendly**: Converts developer commits into customer language
254. **Formats Professionally**: Creates clean, structured changelog entries
265. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
276. **Follows Best Practices**: Applies changelog guidelines and your brand voice
28 
29## How to Use
30 
31### Basic Usage
32 
33From your project repository:
34 
35```
36Create a changelog from commits since last release
37```
38 
39```
40Generate changelog for all commits from the past week
41```
42 
43```
44Create release notes for version 2.5.0
45```
46 
47### With Specific Date Range
48 
49```
50Create a changelog for all commits between March 1 and March 15
51```
52 
53### With Custom Guidelines
54 
55```
56Create a changelog for commits since v2.4.0, using my changelog 
57guidelines from CHANGELOG_STYLE.md
58```
59 
60## Example
61 
62**User**: "Create a changelog for commits from the past 7 days"
63 
64**Output**:
65```markdown
66# Updates - Week of March 10, 2024
67 
68## ✨ New Features
69 
70- **Team Workspaces**: Create separate workspaces for different 
71  projects. Invite team members and keep everything organized.
72 
73- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
74  Navigate faster without touching your mouse.
75 
76## 🔧 Improvements
77 
78- **Faster Sync**: Files now sync 2x faster across devices
79- **Better Search**: Search now includes file contents, not just titles
80 
81## 🐛 Fixes
82 
83- Fixed issue where large images wouldn't upload
84- Resolved timezone confusion in scheduled posts
85- Corrected notification badge count
86```
87 
88**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
89 
90## Tips
91 
92- Run from your git repository root
93- Specify date ranges for focused changelogs
94- Use your CHANGELOG_STYLE.md for consistent formatting
95- Review and adjust the generated changelog before publishing
96- Save output directly to CHANGELOG.md
97 
98## Related Use Cases
99 
100- Creating GitHub release notes
101- Writing app store update descriptions
102- Generating email updates for users
103- Creating social media announcement posts
104 
105