Skip to main content

Purpose

The changelog-automation skill automates the generation and maintenance of project changelogs from Git commit histories, pull requests, and release tags. Adhering to the Keep a Changelog standard and Conventional Commits specifications, it ensures change logs communicate user impact and breaking changes rather than dumping raw commit messages.

Core Philosophy: Focus on User & Developer Impact

A changelog is a communication document, not a raw git log dump.
  • Group Changes by Audience Impact:
    • Added: New features or capabilities.
    • Changed: Modifications in existing functionality.
    • Deprecated: Soon-to-be removed features.
    • Removed: Now-removed features.
    • Fixed: Bug fixes.
    • Security: Vulnerability resolutions.
  • Highlight Breaking Changes: Explicitly state migration steps required for developers or users when breaking changes occur.

Tooling & Setup Integration

Integrate standard semantic versioning and commitlint tooling:
  • Conventional Commits: Enforce commit message formatting (feat:, fix:, docs:, refactor:, perf:).
  • Automation Tools: Use tools such as @commitlint, standard-version, release-it, or semantic-release.

Keep a Changelog Template Format


Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-09-02 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0