changelog

Generate Keep a Changelog documents from Conventional Commit history.

1|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/sk8metalme/ai-agent-setup --skill changelog-sk8metalme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog
Source: https://github.com/sk8metalme/ai-agent-setup/tree/main/plugins/development-toolkit/skills/changelog
Command: npx skills add https://github.com/sk8metalme/ai-agent-setup --skill changelog-sk8metalme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of CHANGELOG.md and release notes, ensuring consistent history using Keep a Changelog, Conventional Commits, and SemVer.

Core Features & Use Cases

  • Keep a Changelog format to standardize release notes
  • Parse Conventional Commits to categorize Added, Changed, Fixed, etc.
  • Generate release notes for GitHub Releases and internal docs
  • Use Case: When preparing a release, run this skill to auto-generate an up-to-date CHANGELOG.md from the commit history and create a release note draft.

Quick Start

Quick Start: Generate the next Unreleased section for CHANGELOG.md in the repository root.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I generate a CHANGELOG from commit history?

Generate a CHANGELOG by parsing your project's commit history using Conventional Commits format. This Skill reads commits, categorizes them (Added, Changed, Fixed, etc.), and outputs a Keep a Changelog compliant Markdown file with versioned entries and an Unreleased section.

What's the difference between Keep a Changelog and Conventional Commits?

Conventional Commits is a commit message format that structures metadata (type, scope, breaking changes); Keep a Changelog is the output format for release notes. This Skill uses Conventional Commits to parse and organize entries into Keep a Changelog's standardized categories and structure.

Can I automate release notes for GitHub Releases?

Yes. This Skill generates release note drafts from your commit history in Keep a Changelog format. Export the generated CHANGELOG or Unreleased section to GitHub Releases, reducing manual documentation work during version releases.

Do I need semantic versioning to use this?

Semantic Versioning (SemVer) is recommended because this Skill organizes commits into version tags and Unreleased sections. While Conventional Commits alone suffice for categorization, SemVer ensures proper versioning structure in the final CHANGELOG output.

What happens if my commits don't follow Conventional Commits?

Commits without Conventional Commits format won't be categorized into Added, Changed, Fixed, etc. This Skill requires structured commit messages to map entries correctly; unstructured commits may be excluded or grouped generically in the CHANGELOG.

How do I handle breaking changes in the CHANGELOG?

Conventional Commits with a breaking change indicator (exclamation mark or footer) are parsed and categorized as breaking changes. This Skill includes them in the appropriate CHANGELOG section, typically highlighted for visibility during major version updates.