patch-notes

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

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

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 while preserving balance numbers and filtering out internal-only changes. ## Core Features & Use Cases - Multi-source change gathering: Reads internal changelogs, docs/CHANGELOG.md, git log between release tags, sprint retrospectives, and balance documents. - Player-language translation: Converts technical jargon (e.g., "refactored damage pipeline") into player-friendly phrasing (e.g., "improved hit detection accuracy") while keeping before/after balance values. - Style and tone control: Supports brief, detailed, and full output styles, auto-detects tone guides and custom templates, and blocks generation when no changelog data exists. - Use Case: Before shipping version 1.2.0 of your game, run the Skill to produce categorized patch notes with highlights, balance tables, bug fixes grouped by system, and known issues, saved to docs/patch-notes/1.2.0.md. ## Quick Start Use $ai-game-studio:patch-notes to generate detailed patch notes for version 1.2.0 from my changelog and git history.

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?

Run the patch-notes skill with a version number, and it reads git log between the previous release tag and the current tag or HEAD as a fallback source. It categorizes commits into player-facing sections like New Content, Bug Fixes, and Performance.

How to write player-facing release notes from developer changelogs?

The skill translates technical language into player-friendly phrasing, such as converting "fixed null reference in inventory manager" into "fixed a crash when opening inventory." It preserves specific before/after values for balance changes while removing purely internal changes.

What output styles does the patch notes generator support?

Three styles are available: brief (bullet points), detailed (with context, highlights, and balance tables), and full (adds developer commentary). Detailed is the default, and a custom template file overrides the built-in styles.

What happens if no changelog data exists for a version?

The skill stops with a BLOCKED verdict and instructs you to run the changelog skill first to generate the internal changelog. It will not fabricate patch notes when no changelog, docs 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 docs/patch-notes-template.md or .ai-game-studio/templates/release-notes.md as a custom output structure if present.

Where are the generated patch notes saved?

After your confirmation, notes are written to docs/patch-notes/[version].md, with an internal archive copy saved under production/releases/. The directory is created automatically if it does not exist.