changelog-generator
npx machina-cli add skill davepoon/buildwithclaude/changelog-generator --openclawChangelog Generator
This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
When to Use This Skill
- Preparing release notes for a new version
- Creating weekly or monthly product update summaries
- Documenting changes for customers
- Writing changelog entries for app store submissions
- Generating update notifications
- Creating internal release documentation
- Maintaining a public changelog/product updates page
What This Skill Does
- Scans Git History: Analyzes commits from a specific time period or between versions
- Categorizes Changes: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
- Translates Technical → User-Friendly: Converts developer commits into customer language
- Formats Professionally: Creates clean, structured changelog entries
- Filters Noise: Excludes internal commits (refactoring, tests, etc.)
- Follows Best Practices: Applies changelog guidelines and your brand voice
How to Use
Basic Usage
From your project repository:
Create a changelog from commits since last release
Generate changelog for all commits from the past week
Create release notes for version 2.5.0
With Specific Date Range
Create a changelog for all commits between March 1 and March 15
With Custom Guidelines
Create a changelog for commits since v2.4.0, using my changelog
guidelines from CHANGELOG_STYLE.md
Example
User: "Create a changelog for commits from the past 7 days"
Output:
# Updates - Week of March 10, 2024
## ✨ New Features
- **Team Workspaces**: Create separate workspaces for different
projects. Invite team members and keep everything organized.
- **Keyboard Shortcuts**: Press ? to see all available shortcuts.
Navigate faster without touching your mouse.
## 🔧 Improvements
- **Faster Sync**: Files now sync 2x faster across devices
- **Better Search**: Search now includes file contents, not just titles
## 🐛 Fixes
- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
- Corrected notification badge count
Inspired by: Manik Aggarwal's use case from Lenny's Newsletter
Tips
- Run from your git repository root
- Specify date ranges for focused changelogs
- Use your CHANGELOG_STYLE.md for consistent formatting
- Review and adjust the generated changelog before publishing
- Save output directly to CHANGELOG.md
Related Use Cases
- Creating GitHub release notes
- Writing app store update descriptions
- Generating email updates for users
- Creating social media announcement posts
Source
git clone https://github.com/davepoon/buildwithclaude/blob/main/plugins/all-skills/skills/changelog-generator/SKILL.mdView on GitHub Overview
Changelog generator analyzes git history, groups changes into features, improvements, bug fixes, and more, and translates them into customer-facing release notes. It formats entries professionally and filters out internal noise to speed up publishing.
How This Skill Works
It scans git history for a given period or version range, categorizes commits into logical groups, and translates technical messages into customer-friendly language. It then outputs clean changelog entries in a consistent format while excluding internal commits, and applies your brand guidelines.
When to Use It
- Preparing release notes for a new version
- Creating weekly or monthly product update summaries
- Documenting changes for customers
- Writing changelog entries for app store submissions
- Maintaining a public changelog/product updates page
Quick Start
- Step 1: From the project repository root, run the changelog generator
- Step 2: Choose a time range or target version (e.g., last release, past week)
- Step 3: Save the output to CHANGELOG.md or copy it to your release notes
Best Practices
- Run from your git repository root to ensure correct history
- Specify date ranges or version filters to focus scope
- Use CHANGELOG_STYLE.md or your brand guidelines for consistent formatting
- Review and adjust the generated changelog before publishing
- Save output directly to CHANGELOG.md or publish to your release notes channel
Example Use Cases
- Create GitHub release notes from a tagged version
- Write app store update descriptions for a new release
- Generate email updates for users about the latest changes
- Post social media announcements highlighting new features and fixes
- Document internal release notes for engineering and support teams
Frequently Asked Questions
Related Skills
theme-factory
davepoon/buildwithclaude
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
docx
davepoon/buildwithclaude
Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks
obsidian-markdown
davepoon/buildwithclaude
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.
davepoon/buildwithclaude
Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.
xlsx
davepoon/buildwithclaude
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas
obsidian-bases
davepoon/buildwithclaude
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.
