patch-notes

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

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill patch-notes-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/patch-notes
Command: npx skills add https://github.com/imgamer/AILearn --skill patch-notes-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Patch notes creation is slow and inconsistent because developer-focused change logs, sprint retrospectives, and internal docs need to be translated into clear, player-friendly communication.

Core Features & Use Cases

  • Player-facing Patch Notes Generation: Produces release notes that categorize changes (new content, gameplay changes, quality of life, bug fixes, performance, known issues) and removes unnecessary internal jargon.
  • Version-Aware Synthesis: Pulls information from version-specific changelog files, QA records, sprint retrospectives, and git history to ensure the notes reflect the actual release scope.
  • Tone & Template Adaptation: Detects available tone/style guidance and optionally uses a patch notes template to format output consistently with your community voice.
  • Publishing Workflow Support: Reviews the draft for player relevance and offers to write the notes to both public and internal archive locations.

Quick Start

Use patch-notes version 1.2.0 to generate player-facing release notes in detailed style.

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 internal changelogs?

Generate player-facing patch notes by synthesizing internal changelogs, sprint context, QA records, and git history. The process translates developer language into clear player benefits, categorizing changes into sections like gameplay tweaks, quality of life improvements, and bug fixes.

How do I translate developer changelog jargon into clear player benefits for release communication?

Translate developer changelog jargon into clear player benefits by synthesizing internal documentation and applying tone adaptation. This process detects available style guidance to format output consistently with your community voice, removing unnecessary internal technical terms for player-ready release notes.

Can I use a specific patch notes template to format output for my community voice?

You can use a specific patch notes template to format output by applying tone and template adaptation. This detects available tone and style guidance from your configured documentation, ensuring the generated release notes categorize changes consistently with your established community voice.

What happens to patch notes generation when internal changelog data is missing?

When changelog data is missing, patch notes generation triggers a blocked-and-instructive fallback. This mechanism safely handles the absence of internal version-specific sources, sprint retrospectives, or git history, providing instructive guidance instead of failing or fabricating release information.

Does patch notes generation support balance changes with accurate before and after values?

Patch notes generation supports balance changes by including accurate before and after balance values. It synthesizes QA records and internal balance documentation, translating these technical adjustments into clear, categorized gameplay changes for the player-facing release output.

How do I write generated patch notes to both public and internal archive locations?

Write generated patch notes to public and internal archive locations through publishing workflow support. After drafting the release notes and reviewing them for player relevance, the workflow offers to save the output to both public communication channels and internal documentation repositories.