Release Notes Generator
CautionGenerate user-facing release notes from git commits, PR descriptions, and issue trackers. Translates technical changes into plain-English feature announcements and bug fix summaries.
Install
Claude Code
Copy the SKILL.md file to .claude/skills/release-notes.md About This Skill
Release Notes Generator bridges the gap between developer-centric git history and user-centric communication. It reads raw commit and PR data and produces polished release notes that resonate with your audience.
Input Sources
The skill reads: git log --oneline output between two tags, PR titles and body text from GITHUB_PR_BODY environment or markdown files, and existing CHANGELOG.md entries for formatting context. It categorizes changes into New Features, Improvements, Bug Fixes, and Breaking Changes.
Audience Adaptation
The same underlying changes can be communicated differently based on audience. The skill supports: user-facing notes that describe what changed and why users benefit, developer changelogs that include migration notes and API changes, and app store updates that emphasize stability and user experience.
Tone and Style
Avoids developer jargon in user-facing notes. Translates "fixed null pointer dereference in auth middleware" into "resolved an issue causing unexpected logouts". Uses active voice and present tense.
Formatting
Outputs standard Keep-a-Changelog format, GitHub Releases Markdown, or App Store plain text with the appropriate character limits per store.
Use Cases
- Generating release notes for a SaaS product from merged PRs
- Writing app store update descriptions from commit history
- Producing a versioned CHANGELOG from conventional commit messages
- Drafting email announcements for major feature releases
Pros & Cons
Pros
- + Translates technical commits into plain-English user-facing copy
- + Supports multiple output formats: CHANGELOG, GitHub Releases, App Store
- + Categorizes changes automatically into features, fixes, and breaking changes
- + Adapts tone based on target audience (users vs developers)
Cons
- - Quality depends on commit message discipline; vague commits produce vague notes
- - Cannot fetch issue tracker context without API token configuration
Related AI Tools
Claude Code
Paid
Anthropic's agentic CLI for autonomous terminal-native coding workflows
- Terminal-native autonomous coding agent
- Full file system and shell access for multi-step tasks
- Deep codebase understanding via repository indexing
GitHub Copilot
Freemium
AI pair programmer that suggests code in real time across your IDE
- Real-time code completions across 30+ languages
- Copilot Chat for natural language code Q&A
- Pull request description and summary generation
Notion AI
Freemium
All-in-one workspace with AI-powered docs, wikis, and databases
- AI-powered Q&A across entire workspace
- Connected databases with relations and rollups
- Wiki with verified pages and ownership
Related Skills
Changelog Generator
CautionRelease notes agent that reads git history, groups commits by type, and produces formatted changelogs following Keep a Changelog conventions.
Technical Writer
CautionTechnical documentation agent that reads codebases, API schemas, and architecture docs to produce clear developer-facing documentation.
Stay Updated on Agent Skills
Get weekly curated skills + safety alerts
每周精选 Skills + 安全预警