change-logger

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

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Change Logger Claude skill automates the generation and maintenance of CHANGELOG.md files directly from git states or commit ranges. By transforming raw code diffs into beginner-friendly, analogy-rich summaries, it bridges the gap between technical implementation and clear communication, making it an essential tool for developer productivity and project transparency.

Use Cases

  • Automated Release Notes: Generate dated, readable changelog entries for new releases to keep users and stakeholders informed without manual writing.
  • Pull Request Summarization: Create clear summaries of complex code changes to help reviewers understand the impact and intent of a PR quickly.
  • Onboarding and Context: Provide new team members or AI agents with a high-level history of project evolution using analogies that simplify complex architectural shifts.
  • Documentation Maintenance: Keep the root CHANGELOG.md updated in real-time based on the current working tree or specific git branches.
namechange-logger
descriptionGenerate and maintain the root CHANGELOG.md in a beginner-friendly, analogy-rich format from git state or a commit range.

Change Logger — quick diffs

Produce a dated, analogy-rich markdown entry in CHANGELOG.md so reviewers (human or model) see what moved without wading through raw diffs.

Main use case

  • Default: include committed changes since the last base marker in CHANGELOG.md plus current working tree edits, then record a new base marker.
  • Optional: limit to staged only or a specific commit range (e.g., main..HEAD).
  • Output: grouped by the first two path segments (e.g., skills/brave-search) with A/M/D/R counts and short analogies.

Commands

  • Show help: ./scripts/change-logger.ts --help
  • Working tree (staged + unstaged): ./scripts/change-logger.ts
  • Staged only: ./scripts/change-logger.ts --staged
  • Commit range: ./scripts/change-logger.ts --range main..HEAD
  • Custom section title: ./scripts/change-logger.ts --title "Landing page polish"

Notes

  • Requires git in PATH and a repository context.
  • Ignored dirs follow git defaults; handles renames via git diff output.
  • Writes/updates CHANGELOG.md at the repo root with dated sections and analogies; ideal for PRs, oracle prompts, or release notes.
  • The base commit marker is stored in each new changelog section and used on subsequent runs to avoid re-listing old commits.