ai-changelog

Installation
SKILL.md

AI-Driven Changelog

Set up a changelog system where AI coding agents write entries under ## [Unreleased] during development, and automation stamps version numbers at release time. No agent ever writes version numbers -- the build process handles that.

Setup Workflow

  1. Detect the project: Check for Makefile, Justfile, package.json, Cargo.toml, pyproject.toml, go.mod. Note which config files contain a "version" field.

  2. Ask the user:

    • Versioning scheme? CalVer YYYY.M.COMMITS (default) works for most projects. SemVer via manual --version override is always available.
    • Include a ## Known Bugs pinned section? (default: yes)
    • Set up GitHub Actions integration? (default: skip unless asked)
  3. Generate CHANGELOG.md: Read references/changelog-template.md for the template. If a CHANGELOG.md already exists, do NOT overwrite it -- insert the ## [Unreleased] structure and HTML comment above existing entries.

  4. Copy scripts/version.py: Copy from this skill's scripts/version.py into the target project's scripts/ directory. Make it executable (chmod +x).

  5. Add build integration: Read references/build-integration.md for patterns. Add stamp-version and version targets to the project's existing build system. If no build system exists, create a minimal Makefile.

Related skills
Installs
11
GitHub Stars
130
First Seen
Mar 27, 2026