changelog-generator

Generate Keep a Changelog entries from Conventional Commit messages.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/Patasse97/claude-skills --skill changelog-generator-patasse97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-generator
Source: https://github.com/Patasse97/claude-skills/tree/main/engineering/changelog-generator
Command: npx skills add https://github.com/Patasse97/claude-skills --skill changelog-generator-patasse97

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Changelog Generator automates creation of release notes from Conventional Commits, ensuring consistent formatting and auditability across releases.

Core Features & Use Cases

  • Parse conventional commits from git ranges or stdin and categorize them into Keep a Changelog sections (Added, Fixed, Changed, etc.)
  • Render a markdown or JSON entry and optionally prepend to an existing CHANGELOG.md
  • Validate and enforce commit formats with a dedicated linter to maintain release discipline
  • Support CI integration by producing machine-readable output and handling version bumps

Quick Start

Generate a changelog entry for a specified git range by running the tool with the appropriate flags.

Frequently Asked Questions about changelog-generator

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

FAQPage Schema
How do I generate release notes from conventional commits?

To generate release notes from conventional commits, you can use a tool that parses git commit ranges or stdin streams and categorizes them into Keep a Changelog sections. It automatically maps commit types like Added, Fixed, and Changed, and renders the output as a Markdown or JSON entry.

What is the Keep a Changelog format for automated CI pipelines?

The Keep a Changelog format structures release notes into distinct sections like Added, Changed, and Fixed. For automated CI pipelines, a changelog generator can parse conventional commits, produce machine-readable JSON or Markdown output, and optionally prepend the entry to an existing CHANGELOG.md file.

Can I prepend new changelog entries to an existing CHANGELOG.md file?

Yes, you can prepend new changelog entries to an existing CHANGELOG.md file. The tool parses conventional commit messages from a specified git range, maps them to Keep a Changelog sections, and writes the rendered Markdown output directly to the top of your existing changelog.

Does this changelog generator handle breaking changes and commit scopes?

Yes, this changelog generator handles breaking changes and commit scopes. It enforces conventional-commit formatting during parsing, correctly categorizes breaking changes into the appropriate Keep a Changelog section, and includes scopes in the rendered Markdown or JSON output.

How do I enforce conventional commit formatting before generating release notes?

You can enforce conventional commit formatting before generating release notes by using a dedicated linter. This validates commit messages to ensure they meet conventional-commit standards, maintaining release discipline and ensuring the generated changelog entries are accurately categorized.

Can I use this tool to output JSON for CI/CD pipelines instead of Markdown?

Yes, you can output JSON for CI/CD pipelines instead of Markdown. The tool supports rendering parsed conventional commits as either a Markdown or JSON entry, providing machine-readable output suitable for downstream CI automation, version bumping, and standalone emission.