Agent skill

change-logger

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

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/change-logger

SKILL.md

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.

Didn't find tool you were looking for?

Be as detailed as possible for better results