patch-notes

Generate categorized player-facing patch notes from release changelog data.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill patch-notes-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/patch-notes
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill patch-notes-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns messy internal release information (git history, sprint context, and changelog entries) into clear, player-facing patch notes you can publish quickly.

Core Features & Use Cases

  • Changelog + history synthesis: combines release changelogs, docs entries, git log diffs, and sprint/QA context into a single structured draft.
  • Tone and template alignment: detects community tone preferences and optionally uses a patch-notes template; otherwise it follows built-in brief/detailed/full formats.
  • Player-language translation: converts developer phrasing into understandable impact statements, including before/after values for balance changes, and groups fixes by category.

Quick Start

Use patch-notes to generate release notes for version 1.2.0 in detailed style, then save them to the project’s patch-notes folder for review.

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 log and changelog data?

To generate patch notes from git log and changelog data, the skill synthesizes release history, sprint context, and docs entries into categorized, player-facing updates. It translates developer phrasing into understandable impact statements grouped by category.

How do I convert internal developer changelogs into community-friendly release communication?

Converting internal developer changelogs into community-friendly release communication requires translating technical changes into player-language impact statements. The skill detects community tone preferences and applies templates to produce publishable updates across brief, detailed, or full formats.

Can I include before and after balance values when generating gameplay patch notes?

Yes, you can include before and after balance values when generating gameplay patch notes. The skill explicitly supports translating balance changes into player-facing updates by providing before/after values alongside categorized gameplay modifications.

What is the best way to format patch notes for new features, bug fixes, and quality of life improvements?

The best way to format patch notes for features, fixes, and quality of life improvements is categorizing them into distinct publishable update groups. The skill outputs brief, detailed, or full formats that group fixes by category and validate version context.

Does patch note generation work without a predefined template for community tone alignment?

Patch note generation works without a predefined template by detecting community tone preferences and falling back to built-in formats. If no template is provided, it automatically follows brief, detailed, or full output styles based on available release data.

What happens if changelog data is missing when creating release notes for a sprint?

If changelog data is missing when creating release notes, the skill falls back to locating alternative release data sources. It validates that version context exists before producing categorized output, ensuring generated patch notes remain accurate and publishable.