CleanArchitecture-template/.brain/.agent/skills/engineering-advanced-skills/changelog-generator/README.md

Changelog Generator

Automates release notes from Conventional Commits with Keep a Changelog output and strict commit linting. Designed for CI-friendly release workflows.

Quick Start

# Generate entry from git range
python3 scripts/generate_changelog.py \
  --from-tag v1.2.0 \
  --to-tag v1.3.0 \
  --next-version v1.3.0 \
  --format markdown

# Lint commit subjects
python3 scripts/commit_linter.py --from-ref origin/main --to-ref HEAD --strict --format text

Included Tools

• scripts/generate_changelog.py: parse commits, infer semver bump, render markdown/JSON, optional file prepend
• scripts/commit_linter.py: validate commit subjects against Conventional Commits rules

References

• references/ci-integration.md
• references/changelog-formatting-guide.md
• references/monorepo-strategy.md

Installation

Claude Code

cp -R engineering/changelog-generator ~/.claude/skills/changelog-generator

OpenAI Codex

cp -R engineering/changelog-generator ~/.codex/skills/changelog-generator

OpenClaw

cp -R engineering/changelog-generator ~/.openclaw/skills/changelog-generator