Agent-Skills.md

Agent Skills: Change Logger — quick diffs

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

UncategorizedID: doubleflannel/12-30-test-codex-ip/change-logger

Repository

doubleflannel/12-30-test-codex-ip
doubleflannel

Install this agent skill to your local

pnpm dlx add-skill https://github.com/doubleflannel/12-30-test-codex-ip/tree/HEAD/skills/change-logger

Skill Files

Browse the full folder contents for change-logger.

Download Skill

Loading file tree…

skills/change-logger/SKILL.md

Skill Metadata

Name
change-logger
Description
Generate 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.