generate-changelog

Generate a Markdown changelog from git commits grouped by conventional commit types.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/mvillmow/ProjectOdyssey --skill generate-changelog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-changelog
Source: https://github.com/mvillmow/ProjectOdyssey/tree/main/.claude/skills/tier-2/generate-changelog
Command: npx skills add https://github.com/mvillmow/ProjectOdyssey --skill generate-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git.

What problem does it solves?

Manually compiling release notes and version history from Git commit messages is a tedious and error-prone task that delays release preparation.

Core Features & Use Cases

  • Automated Commit Extraction: Extracts commit messages since the last release, parsing conventional commit types (feat, fix, docs).
  • Categorized Changelog: Groups changes into sections like Features, Fixes, and Documentation for readability.
  • Use Case: When preparing for a new software release, use this skill to automatically generate a formatted changelog, saving hours of manual compilation and ensuring accuracy.

Quick Start

Use the generate-changelog skill to generate a markdown changelog from your Git commits, reversed and formatted.

Frequently Asked Questions about generate-changelog

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

FAQPage Schema
How do I automatically generate a changelog from Git commits?

Generate a changelog by extracting commits since the last Git tag, parsing conventional commit types (feat, fix, docs, refactor, test), and formatting them into categorized Markdown sections. This automates release notes compilation and ensures consistency across version documentation.

What are conventional commits and why do they matter for changelogs?

Conventional commits follow a structured format (type: description) that makes commit intent explicit. Changelog generation relies on this format to automatically categorize changes into Features, Fixes, Documentation, and other sections, reducing manual sorting.

Can I use this to generate release notes for every software release?

Yes. This skill extracts commits between Git tags, groups them by type, and produces formatted release notes with version numbers and dates. Use it before each release to generate accurate, timestamped documentation automatically.

What do I need to set up before generating a changelog?

You need an initialized Git repository with commit history and at least one tag marking a previous release. The skill parses commits since the last tag, so existing version tags are required to determine the changelog scope.

Does this work if my commits don't follow conventional commit format?

The skill is optimized for conventional commits but can extract any commit message. Non-conventional commits may appear in a default section rather than categorized groups, reducing the clarity of your changelog output.

What output formats does the changelog use?

Changelog generation produces Markdown or plain text output with structured sections for each commit type, version numbers, release dates, and contributor links formatted for readability in release notes.