store-changelog
Generate release notes for app stores (Android Play Store, iOS App Store, macOS App Store, Linux Flatpak). Use when the user asks for changelogs, release notes, or store descriptions based on git history.
When & Why to Use This Skill
This Claude skill automates the creation of platform-specific release notes by analyzing git history. It intelligently categorizes commits into features, improvements, and bug fixes, then formats them to meet the specific requirements of the Android Play Store, iOS App Store, macOS App Store, and Linux Flatpak (XML). By transforming technical git logs into user-friendly changelogs, it streamlines the app deployment process and ensures consistency across different distribution channels.
Use Cases
- Automating the 'What's New' section for mobile app updates on Google Play and Apple App Store to save manual drafting time.
- Generating structured XML metadata for Linux Flatpak releases directly from repository tags and commit messages.
- Translating technical git commit descriptions into polished, narrative-style release notes for macOS desktop applications.
- Ensuring character limit compliance for Android store descriptions while highlighting the most impactful user-facing changes.
| name | store-changelog |
|---|---|
| description | Generate release notes for app stores (Android Play Store, iOS App Store, macOS App Store, Linux Flatpak). Use when the user asks for changelogs, release notes, or store descriptions based on git history. |
Store Changelog Generator
Generate release notes for App stores based on git history since a specified tag.
Instructions
Get the tag name:
- If the user provides a tag name (e.g.,
1.0.0orv1.0.0), use it - If not provided, automatically get the latest tag using:
git describe --tags --abbrev=0 - Inform the user which tag is being used
- If the user provides a tag name (e.g.,
Analyze git history: Run
git log <tag>..HEAD --pretty=format:"%h %s%n%b" --no-mergesto get all commits since the tag, including both commit messages and descriptions.Identify changes: Categorize commits into:
- New features
- Improvements
- Bug fixes
Generate platform-specific release notes following the formats below.
Output Formats
Android (Play Store)
- Maximum 500 characters
- Bullet point format
- Focus on top 3-4 most impactful changes
- Example:
• New reader mode for distraction-free reading • Improved sync reliability with FreshRSS • Fixed crash when opening large feeds
iOS (App Store)
- User-friendly narrative format
- Highlight iOS-specific improvements (scrolling, touch interactions, mobile layout)
- Group by: New Features, Improvements, Bug Fixes
- Example:
New Features: • Reader mode now provides a clean, distraction-free reading experience. Improvements: • Smoother scrolling and faster feed loading on all devices. Bug Fixes: • Fixed an issue where the app could crash when opening feeds with many articles.
macOS (App Store)
- User-friendly narrative format
- Highlight macOS-specific improvements (desktop layout, toolbar, keyboard shortcuts, interface)
- Separate from iOS since they are different apps
- Group by: New Features, Improvements, Bug Fixes
Linux (Flatpak metainfo.xml)
- XML format with individual
<p>tags - Concise, one-line descriptions per change
- Format:
<release version="X.X.X" date="YYYY-MM-DD"> <description> <p>Feature or fix description</p> <p>Another change</p> </description> </release>
Resources
references/release-notes-guidelines.md: Language, filtering, and QA rules for App Store notes.