changelog-from-commits

# Changelog From Commits ## Overview Parses `git log` against the [Conventional Commits](https://www.conventionalcommits.org/) spec and prints a categorized changelog: Features, Fixes, Performance, Refactoring, Docs, Tests, Build, CI, Chore, Other, plus a BREAKING CHANGES section pulled from `!` markers and `BREAKING CHANGE:` footers. Deterministic — the categorization is a fact about the commit message, not a judgment call, so a script produces it more reliably than a model re-reading commit subjects. **Core principle:** A changelog section is either correct (matches the commit's own declared type) or it silently drops/miscategorizes a change. Parsing is not the place for approximation. ## Usage ```bash bash ${CLAUDE_SKILL_DIR}/scripts/generate.sh [from-ref] [to-ref] ``` - `from-ref` defaults to the most recent tag, or the repo's root commit if there are no tags. - `to-ref` defaults to `HEAD`. - Requires a git repository; exits 2 if run outside one. - Prints Markdown to stdout — pipe into a file, or paste directly into `CHANGELOG.md`. ```bash bash ${CLAUDE_SKILL_DIR}/scripts/generate.sh v1.2.0 HEAD > /tmp/new-entries.md bash ${CLAUDE_SKILL_DIR}/scripts/generate.sh # since the last tag, to HEAD ``` ## What it gets right and what it doesn't **Reliable:** `type(scope)!: subject` parsing, breaking-change detection (`!` or a `BREAKING CHANGE:` footer), section grouping, short-hash linking, merge commits excluded automatically. **Falls back to "Other":...