changelog

Generate internal and player-facing changelogs from git commits and sprint reports.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually writing release notes by automatically compiling a changelog from your repository’s git history, sprint context, and design documents.

Core Features & Use Cases

  • Version- or Sprint-scoped generation: Produce changelogs for a specific git tag/version or for changes that fall within a sprint date range.
  • Change categorization: Classify commits into New Features, Improvements, Bug Fixes, Balance Changes, Known Issues, and Miscellaneous for clearer release communication.
  • Two output modes: Generate both an internal changelog (useful for review and team tracking) and a player-facing changelog (ready for community posting after review), including metrics like total commits and commits without task references.

Quick Start

Ask the changelog skill to generate the internal and player-facing changelogs for the latest sprint by using the argument sprint number.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I automatically generate release notes from git commits?

To generate release notes from git commits, aggregate your repository's commit history, sprint reports, and design documents for a specific version. The system classifies each commit into categories like features, improvements, and bug fixes, then outputs formatted markdown changelogs for both internal and player-facing audiences.

What is the best way to categorize git commits for a sprint retrospective?

Categorizing git commits for a sprint retrospective involves classifying logs into structured buckets like New Features, Bug Fixes, Balance Changes, and Known Issues. By aggregating sprint reports and design documents, you produce a structured change summary that tracks total commits and identifies missing task references.

Can I create both internal and player-facing changelogs from a single git tag?

Yes, you can create both internal and player-facing changelogs from a single git tag. By resolving the git tag version and extracting the log, the system generates a detailed internal changelog for team tracking and a separate player-facing version ready for community posting.

How do I compile a changelog for a specific sprint date range instead of a git tag?

To compile a changelog for a specific sprint date range instead of a git tag, provide the sprint number. The tool scans commits, sprint reports, and design documents that fall within that date range, categorizing them into structured buckets for your release notes.

What commit classifications are supported when generating version documentation?

When generating version documentation, supported commit classifications include New Features, Improvements, Bug Fixes, Balance Changes, Known Issues, and Miscellaneous. This categorization helps structure release notes and communicate changes clearly to both internal teams and players.

Does the changelog generation process track commits without task references?

Yes, the changelog generation process tracks commits without task references. It performs per-commit classification and task-reference counting, including metrics like total commits and unlinked tasks in the internal changelog output to help teams identify missing documentation.