patch-notes

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

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/onemanking/the-operator --skill patch-notes-onemanking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-notes
Source: https://github.com/onemanking/the-operator/tree/main/.github/skills/patch-notes
Command: npx skills add https://github.com/onemanking/the-operator --skill patch-notes-onemanking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing release notes that players actually understand is tedious: developers must dig through git logs, changelogs, and sprint retrospectives, then translate internal jargon into clear player communication. This Skill automates that entire pipeline. ## Core Features & Use Cases - Multi-source change gathering: Collects changes from internal changelogs, git log between release tags, sprint retrospectives, balance documents, and QA bug records. - Automatic categorization: Sorts changes into New Content, Gameplay Changes, Quality of Life, Bug Fixes, Performance, and Known Issues. - Developer-to-player translation: Converts technical language (e.g., "refactored damage calculation pipeline") into player-friendly phrasing ("improved hit detection accuracy") while preserving balance numbers. - Three output styles: brief (bullet points), detailed (with context and balance tables), and full (adds developer commentary). - Use Case: Before shipping version 1.2.0 of your game, run the skill to produce a complete patch notes document saved to production/releases/1.2.0/patch-notes.md, ready for your community channels. ## Quick Start Ask the AI to generate detailed patch notes for version 1.2.0 using the patch-notes skill.

Frequently Asked Questions about patch-notes

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

FAQPage Schema
How do I generate patch notes from git history?

Invoke the skill with a version number, and it runs git log between the previous release tag and the current tag or HEAD. It then merges those commits with changelogs and sprint data, categorizes them, and writes player-facing notes.

How to write release notes players actually understand?

Translate technical changes into player impact: "fixed null reference in inventory manager" becomes "fixed a crash when opening inventory." The skill performs this translation automatically and removes purely internal changes that do not affect players.

What output formats does the patch-notes skill support?

Three styles via the --style flag: brief produces compact bullet lists, detailed adds highlights, balance tables, and grouped bug fixes, and full includes developer commentary sections. The default style is detailed.

Where are the generated patch notes saved?

The skill writes the final Markdown file to production/releases/[version]/patch-notes.md, creating the directory if it does not exist. It also reports change counts by category and lists excluded internal changes for review.

What are the limitations of automated patch note generation?

The skill depends on the quality of source data: sparse commit messages or missing changelogs produce thinner notes. It reads optional inputs like sprint retrospectives and QA records only when they exist, so teams without those artifacts get git-only summaries.