changelog

Generate release notes from git commit ranges for multiple audiences.

11|Updated Mar 19, 2019
One-click install
npx skills add https://github.com/lukoshkin/evangelist --skill changelog-lukoshkin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog
Source: https://github.com/lukoshkin/evangelist/tree/main/conf/ai/claude/skills/changelog
Command: npx skills add https://github.com/lukoshkin/evangelist --skill changelog-lukoshkin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Churn-free generation of release notes from git commit ranges, saving time and reducing manual drafting for engineers and product teams.

Core Features & Use Cases

  • Supports common range forms (tag-to-tag, commit-to-HEAD, and last-N-commits) to cover most release scenarios.
  • Produces audience-tailored notes that can be shared publicly or kept internal, with optional references and summaries.
  • Parses commit messages to extract meaningful changes and compiles them into structured, readable changelogs.

Quick Start

Provide a git commit range (e.g., v1.0.0..HEAD) and generate the release notes.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I generate release notes from a git commit range?

To generate release notes from a git commit range, you provide a span such as tag-to-tag or commit-to-HEAD. The tool parses commit messages, filters them, and formats the changes into structured, reader-friendly changelogs suitable for distribution.

What is the best way to automate changelog creation from commit messages?

Automating changelog creation from commit messages involves parsing a given commit range to extract meaningful changes. This process compiles filtered commit data into structured, audience-tailored summaries, reducing manual drafting time for engineering teams.

Can I create audience-tailored documentation from git tags?

Yes, you can create audience-tailored documentation from git tags by using the tag-to-tag range feature. It formats extracted commit changes into reader-friendly summaries that can be shared publicly or kept internal for specific audiences.

Does this changelog generator support last-N-commits ranges?

Yes, this changelog generator supports last-N-commits ranges alongside tag-to-tag and commit-to-HEAD formats. It reads the specified commit messages, filters them, and compiles them into readable release notes with appropriate references.

Why manually draft release notes when you can parse commit ranges?

Manually drafting release notes is time-consuming compared to parsing commit ranges. Automatically generating reader-friendly summaries from commit messages saves time, reduces churn, and provides structured documentation for product teams and engineers.

When do I need to use a commit-to-HEAD range for documentation?

You need to use a commit-to-HEAD range for documentation when tracking unreleased changes leading up to a new version. It reads all commits up to HEAD, extracting meaningful changes to compile into a structured, reader-friendly changelog.