patch-notes

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nevesb/idol-agency-maker --skill patch-notes-nevesb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/nevesb/idol-agency-maker/tree/main/.claude/skills/patch-notes
Command: npx skills add https://github.com/nevesb/idol-agency-maker --skill patch-notes-nevesb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts developer-facing change records, git history, and sprint notes into clear, player-facing patch notes so community teams can communicate updates quickly and consistently without manual translation or loss of context.

Core Features & Use Cases

  • Aggregates change sources: reads production release changelogs, docs/CHANGELOG.md, git log ranges, sprint retrospectives, balance docs, and QA records to build a comprehensive change set.
  • Categorizes and translates: maps technical entries into player-facing categories (New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, Known Issues) and rewrites developer language into plain user-facing descriptions while preserving numeric balance values.
  • Tone and template support: detects and applies tone guides or user templates if present and offers three output styles (brief, detailed, full); blocks generation when no changelog data is available to avoid incomplete notes.
  • Save and review workflow: presents a draft with change counts and excluded internal changes, prompts to write the public and internal files, and writes to docs/patch-notes/[version].md and production/releases/[version]/patch-notes.md when approved.
  • Use Case: community managers producing release notes for a game release want consistent, player-friendly messaging derived from developer artifacts.

Quick Start

Create detailed patch notes for version 1.2.0 from the repository changelogs 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 convert git changelogs into player-facing patch notes?

To convert git changelogs into player-facing patch notes, aggregate repository git history, docs/CHANGELOG.md, and sprint notes to generate categorized descriptions. The output translates technical commit entries into plain language across categories like Gameplay Changes and Bug Fixes.

Can I generate game patch notes from sprint retrospectives and balance documents?

Yes, you can generate game patch notes from sprint retrospectives and balance documents by reading design/balance files and QA records. The process categorizes changes into player-facing sections while preserving numeric balance values from the original design documents.

What is the best way to automate release notes from git history for a game?

Automating release notes from git history involves reading version tags and commit ranges to produce brief, detailed, or full patch notes. This workflow maps developer language to user-facing categories and writes outputs to docs/patch-notes and production/releases directories.

Do I need a tone guide to generate patch notes from repository changelogs?

You do not need a tone guide to generate patch notes from repository changelogs, but the workflow detects and applies optional tone or template files if present. It blocks generation entirely when no changelog data is available to prevent incomplete notes.

How does categorizing patch notes from QA records and balance docs work?

Categorizing patch notes from QA records and balance docs works by mapping internal change entries into player-facing categories such as New Content, Quality of Life, and Known Issues. Developer language is rewritten into plain descriptions while numeric balance values are preserved.

What happens to internal changes when generating public patch notes from git history?

When generating public patch notes from git history, internal changes are excluded from the final output. The workflow presents a draft with change counts and excluded internal entries, then prompts for approval before writing public and internal files.