change-logger

Generate a readable CHANGELOG.md from git commits since a base marker.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/doubleflannel/12-30-test-codex-ip --skill change-logger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-logger
Source: https://github.com/doubleflannel/12-30-test-codex-ip/tree/main/skills/change-logger
Command: npx skills add https://github.com/doubleflannel/12-30-test-codex-ip --skill change-logger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Generate and maintain the root CHANGELOG.md in a beginner-friendly, analogy-rich format from git state or a commit range.

Core Features & Use Cases

  • Automatically generate dated changelog entries from the current git state and apply a base marker to track progress.
  • Support optional commit ranges (e.g., main..HEAD) and staged-only changes; group changes by path segments with concise analogies.
  • Ideal for PRs, release notes, and team communications, keeping changelogs human-friendly.

Quick Start

Run the change-logger script to create or update CHANGELOG.md from your current git state.

Frequently Asked Questions about change-logger

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

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

Automatically generate a changelog by running a script that reads your current git state and writes dated, readable entries to CHANGELOG.md. It groups changes by path segments and applies a base marker to track progress without re-listing old commits.

Can I generate release notes for a specific commit range like main..HEAD?

Yes, you can generate release notes for a specific commit range like main..HEAD. The script processes commits within your specified range or staged-only changes, grouping them into concise, analogy-rich entries for your changelog.

What's the best way to keep a changelog human-friendly for team communications?

Keep a changelog human-friendly by generating analogy-rich entries grouped by path segments. This format translates raw git state into readable notes, making it ideal for PRs, release notes, and team communications.

How does the base marker work when updating CHANGELOG.md?

The base marker tracks your changelog progress by recording the last processed commit. It prevents the script from re-listing old commits on subsequent runs, ensuring CHANGELOG.md only appends new, dated entries from the current git state.

Does this changelog generator work with staged-only changes?

Yes, the changelog generator works with staged-only changes. You can configure the script to process only staged files instead of the full commit range, capturing immediate working directory updates for your release notes.

Why use an analogy-rich format for changelog entries?

An analogy-rich format makes changelog entries beginner-friendly and highly readable. By grouping git changes by path segments with concise analogies, the generated CHANGELOG.md communicates technical updates clearly for PRs and team updates.