changelog

Generate structured internal and player-facing changelogs from git history and project artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The changelog Skill automates the tedious and error-prone process of creating release documentation by synthesizing git commits, sprint reports, and design documents into a structured internal changelog and a player-facing summary.

Core Features & Use Cases

  • Automated Git Parsing: Reads recent git history and tags to collect commits and commit metadata.
  • Contextual Enrichment: Incorporates sprint reports and design documents to explain why changes were made.
  • Dual Output: Produces a detailed internal changelog with categorized entries and metrics plus a concise, player-friendly changelog ready for community release.
  • File Management: Offers to append or overwrite docs/CHANGELOG.md with sensible defaults and checks for repository state.
  • Use Case: Prepare release notes after a sprint by combining commits, sprint reports, and design docs into both engineering and public-facing changelogs.

Quick Start

Generate internal and player-facing changelogs for version v1.2.0 using the repository git history and production/sprints/ reports.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I auto-generate release notes from git history and sprint reports?

To auto-generate release notes from git history, the Skill reads recent commits, sprint reports, and design documents to synthesize structured internal changelogs and player-facing summaries. It parses repository tags and commit metadata to categorize entries for release tracking.

Can I create separate internal and player-facing changelogs from the same git commits?

Yes, you can create separate internal and player-facing changelogs from the same git commits. The Skill produces dual output: a detailed internal changelog with categorized entries and metrics, plus a concise, player-friendly summary ready for community release.

What's the best way to generate game development changelogs after a sprint?

The best way to generate game development changelogs after a sprint is to combine repository git history with production/sprints/ reports and design/gdd directories. The Skill enriches commit data with sprint reports and design documents to explain why changes were made.

Does generating changelogs require read access to specific project directories?

Yes, generating changelogs requires read access to git history, production/sprints and design/gdd directories, and the ability to read or write docs/CHANGELOG.md. The Skill checks repository state and offers append or overwrite options with sensible defaults.

Why do I need sprint reports and design documents to generate git changelogs?

You need sprint reports and design documents to generate git changelogs because they provide contextual enrichment. While git commits show what changed, sprint reports and design docs explain why changes were made, producing more meaningful internal and player-facing release notes.

What are the limitations of automating changelog generation from repository history?

A limitation of automating changelog generation from repository history is that it depends on well-structured commit messages and available sprint documentation. Without proper context in production/sprints and design/gdd directories, the generated internal and player-facing changelogs may lack meaningful explanatory detail.