patch-notes

Generate player-facing patch notes from git history, changelogs, and sprint data.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill patch-notes-claretagrapelike32
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/claretagrapelike32/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/patch-notes
Command: npx skills add https://github.com/claretagrapelike32/codex-ai-game-studio --skill patch-notes-claretagrapelike32

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Translating internal developer changelogs, git commits, and sprint records into clear, engaging patch notes that players actually understand is time-consuming and error-prone. This Skill automates that translation, categorizing changes and rewriting technical jargon into player-friendly language. ## Core Features & Use Cases - Multi-source change gathering: Reads internal changelogs, docs/CHANGELOG.md, git log between release tags, sprint retrospectives, and balance documents. - Automatic categorization and translation: Groups changes into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues, converting developer language into player-facing descriptions while preserving balance before/after values. - Style and tone control: Supports brief, detailed, and full output styles, detects custom tone guides and patch notes templates, and saves results to docs/patch-notes/ with an internal archive copy. - Use Case: Before shipping version 1.2.0 of your game, run the Skill to compile all merged changes since the last tag into a polished, categorized patch notes draft ready for community review. ## Quick Start Generate detailed patch notes for version 1.2.0 from the git history and changelog, then save them to the docs folder.

Frequently Asked Questions about patch-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate patch notes from git history?

Provide a release version and the Skill runs git log between the previous release tag and the current tag or HEAD, then categorizes commits into player-facing sections. It also merges data from changelogs and sprint retrospectives when available.

How to write player-friendly patch notes from developer changelogs?

The Skill translates technical entries into player language, such as converting a null reference fix into a crash fix description. It removes purely internal changes and preserves specific before/after values for balance adjustments.

What output styles does patch note generation support?

Three styles are available: brief with bullet points, detailed with categorized sections and balance tables, and full which adds developer commentary. The default is detailed, and custom templates in docs/ can override the built-in formats.

What happens if no changelog data exists for a version?

The Skill stops with a BLOCKED verdict and instructs you to run the changelog generation step first. It will not fabricate patch notes when no changelog, CHANGELOG.md entry, or git log data is available.

Can I customize the tone and template of generated patch notes?

Yes. The Skill checks project.json, docs/PATCH-NOTES-STYLE.md, and design/community/tone-guide.md for tone guidance, and uses templates from docs/patch-notes-template.md or .ai-game-studio/templates/release-notes.md when present.