patch-notes

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

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill patch-notes-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/patch-notes
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill patch-notes-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns developer-facing change logs, git history, sprint retrospectives, and balance documents into clear, player-friendly patch notes so community teams can communicate updates without technical jargon.

Core Features & Use Cases

  • Aggregate Sources: Reads production/releases/[version]/changelog.md, docs/CHANGELOG.md, sprint retrospectives, design/balance documents, and git logs to collect change data.
  • Categorize & Translate: Classifies items into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues while translating technical language into player-facing descriptions and preserving numeric balance values.
  • Templates, Tone, and Save: Detects tone guides and patch-note templates, supports brief/detailed/full styles, presents a review checklist, and can write the final notes to docs/patch-notes and production/releases for archival.

Quick Start

Generate patch notes for version 1.2.0 in detailed style and ask to save them to docs/patch-notes/1.2.0.md.

Frequently Asked Questions about patch-notes

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

FAQPage Schema
How do I generate player-facing patch notes from git history and changelogs?

This Skill generates player-facing patch notes by parsing git history, changelogs, and sprint notes, categorizing technical commits into player-ready markdown descriptions while preserving numeric balance values.

What is the best way to categorize game development changes for community communication?

The best way to categorize game development changes is classifying git commits and balance documents into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues, translating technical jargon into player-friendly text.

Can I use custom templates and tone guides to format release notes from repository commits?

Yes, you can use custom templates and tone guides to format release notes. The Skill detects these files and supports brief, detailed, and full styles to output categorized markdown suitable for publishing to players.

Does generating patch notes from git logs require read access to repository files?

Yes, generating patch notes from git logs requires read access to repository files and git logs to parse changelog files, sprint retrospectives, and balance documents. Optional tone or template files can also be read.

How do I save generated patch notes to an archive within my repository?

You save generated patch notes to a repository archive by writing the final categorized markdown directly to docs/patch-notes and production/releases directories for long-term archival and production tracking.