patch-notes

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

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill patch-notes-carlosq96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/patch-notes
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill patch-notes-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts technical developer artifacts—git history, internal changelogs, sprint notes, and balance documents—into clear, engaging patch notes that players can read and understand without developer jargon.

Core Features & Use Cases

  • Automated Aggregation: Reads release changelogs, docs/CHANGELOG.md, production release notes, sprint retrospectives, and git logs to assemble change candidates.
  • Tone & Template Detection: Detects project tone guides and patch note templates and applies them to ensure consistent voice and structure.
  • Categorization & Translation: Classifies items into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues, and translates developer wording into player-facing language.
  • Multiple Output Styles: Produces Brief, Detailed, or Full outputs and can save public and internal copies to designated docs paths.
  • Use Case: A community manager preparing release communications uses this Skill to transform internal changelogs and sprint retrospectives into a polished patch notes draft ready for review.

Quick Start

Generate patch notes for version 1.2.0 in detailed style using 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 generate player-facing patch notes from git history and changelogs?

Generate player-facing patch notes by feeding git history, internal changelogs, and sprint retrospectives into an automated processor that categorizes and translates developer changes into clear community communications. The system reads repository changelogs and release notes to assemble change candidates automatically.

Can I translate developer changelog entries into categorized release notes for a game update?

Yes, you can translate developer changelog entries into categorized release notes by classifying items into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues, converting technical jargon into language players understand.

Does this patch notes generator work with sprint retrospectives and production release directories?

This patch notes generator works with sprint retrospectives, production release directories, repository changelogs, and git logs to aggregate change candidates. It requires access to these internal development artifacts to assemble and translate them into player communications.

What is the best way to format release notes for different audiences from internal changelogs?

The best way to format release notes from internal changelogs is producing Brief, Detailed, or Full output styles. This approach detects project tone guides and templates to ensure consistent voice and can save both public and internal copies to designated docs paths.

Do I need a patch-notes template to maintain a consistent tone across community communications?

You do not need a patch-notes template as it is optional, but providing one helps maintain a consistent tone. The system detects project tone guides and templates automatically and applies them to ensure your release notes have a structured voice.

Why does my release notes draft still contain developer jargon instead of player-ready language?

Release notes drafts contain developer jargon when raw git logs are not translated through a categorization and tone detection process. Translating developer wording into player-facing language requires classifying items and applying project tone guides to strip technical terminology.