release-notes

Generate grouped Markdown release notes from git history since the last tag.

3|4|Updated Mar 22, 2014
One-click install
npx skills add https://github.com/gui81/scorekeeper --skill release-notes-gui81
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-notes
Source: https://github.com/gui81/scorekeeper/tree/main/.claude/skills/release-notes
Command: npx skills add https://github.com/gui81/scorekeeper --skill release-notes-gui81

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

No CHANGELOG exists; generate concise, grouped release notes from git history since the last tag, ready for distribution in GitHub Releases.

Core Features & Use Cases

  • Derives notes from commit subjects and categorizes them into Added, Fixed, Changed, and Chore buckets.
  • Produces a Markdown release notes document suitable for GitHub Releases, with sections for reviewers and stakeholders.
  • Applicable to any repository lacking an up-to-date changelog, facilitating timely communications of changes.

Quick Start

Run the release-notes skill to generate the release notes for the current repository.

Frequently Asked Questions about release-notes

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

FAQPage Schema
How do I generate release notes from git history for a GitHub release?

Generate release notes from git history by reading commit subjects via git log since the last tag, categorizing them into Added, Fixed, Changed, and Chore buckets, and outputting a Markdown document ready for GitHub Releases.

What's the best way to create a changelog from commit messages when no CHANGELOG exists?

Creating a changelog from commit messages involves parsing git history since the last release tag, grouping commit subjects into logical change categories like Added and Fixed, and producing a human-readable Markdown summary for stakeholders.

Does generating release notes from git history require write access to the repository?

Generating release notes from git history requires only read-only access to the repository via git log, git describe, and git tag commands to extract commit subjects and determine the last release tag safely.

Can I categorize git commit subjects into added and fixed buckets for release summaries?

Categorizing git commit subjects into Added and Fixed buckets is supported by grouping parsed commit subjects from git history into structured Markdown sections suitable for reviewer and stakeholder distribution.

How to group git log commits into a Markdown document for release distribution?

Grouping git log commits into a Markdown document requires running git log to fetch commit subjects since the last tag, sorting them into change buckets, and formatting the output as a structured Markdown file for GitHub Releases.

What are the limitations of using git history for release notes instead of a maintained changelog?

Using git history for release notes depends entirely on commit subject quality, meaning poorly structured or vague commit messages will result in less meaningful categorized Markdown summaries compared to an explicitly maintained changelog.