
Patch Notes
Generate player-facing patch notes from git history and sprint data
What You Can Do
You can feed Claude your internal changelog, git history, and sprint retrospectives, and it will generate polished, player-friendly patch notes that translate developer jargon into accessible language. The skill supports three output styles—brief bullet points, detailed explanations, or full commentary—and automatically detects and applies your team's tone and voice guidelines for consistency.
Features
internal changelogs, git history, sprint retrospectives, balance change documents, and QA bug records
brief (bullets), detailed (with context), or full (with developer commentary)
reads `.claude/docs/technical-preferences.md`, `PATCH-NOTES-STYLE.md`, and community tone guides to match your brand voice
targets specific releases (e.g., 1.2.0) and excludes irrelevant changes
automatically searches git logs, sprint data, and design documents if primary changelog is missing
flags missing changelog data upfront and guides you to generate internal changelogs first
accepts version number and style flags via simple command syntax
designed for non-technical communicators managing player relations
Example Output
Input: patch-notes 2.5.1 --style detailed
Output:
Patch Notes 2.5.1
New Features
- Party Crossplay — Squad up with friends across all platforms. Cross-platform matchmaking now live for quickplay and competitive modes.
- Seasonal Battle Pass — Earn exclusive cosmetics and rewards over 12 weeks. Free and premium track available.
Balance Changes
- Warrior: Heavy Strike cooldown reduced from 8s to 6s (was underperforming in solo queue)
- Mage: Fireball damage reduced 12% (addressed feedback from competitive ladder)
Bug Fixes
- Fixed crash when accepting party invite during matchmaking
- Resolved audio desync in team chat
- Corrected reward count display in battle pass UI
Input: patch-notes 1.0.0 --style brief
Output:
v1.0 Launch
- Full campaign (8 acts)
- Multiplayer arena (6 maps)
- Customization system (50+ cosmetics)
- Cross-platform play
What's Included
- SKILL.md: Complete skill definition with argument parsing, multi-source data gathering, and tone guide detection
- Changelog data structure: Templates for `production/releases/[version]/changelog.md` and `docs/CHANGELOG.md` organization
- Tone guide template: Sample `.claude/docs/technical-preferences.md` and `PATCH-NOTES-STYLE.md` for voice/style customization
- Git log integration checklist: Best practices for tagging releases and organizing sprint retrospectives for reliable data gathering
- Output style reference: Examples and guidelines for brief, detailed, and full output modes with player-friendly language
Who It's For
- Community Managers — Transform technical release data into engaging player communication without deep engineering knowledge
- Game Producers — Manage patch release messaging and ensure consistency with brand voice across all versions
- DevOps/Release Engineers — Automate patch notes generation from existing changelogs and git workflows
- Marketing Teams — Create player-facing announcements that highlight features and balance changes in accessible language
- QA Leads — Synthesize bug fixes and known issues into digestible player communications
Best For
- Game and app release announcements — Regular patch cycles with new features, balance adjustments, and bug fixes
- Multi-platform communication — Unified patch notes across console, PC, and mobile with consistent messaging
- Tone-consistent documentation — Applying brand voice guidelines to all public-facing release content
- Rapid release cycles — Sprint-based development where quick, accurate patch notes are essential for player trust
- Community engagement — Highlighting changes in a way that excites players and explains the reasoning behind adjustments







