Transforms raw git history and PR descriptions into polished, audience-appropriate changelogs. Parses conventional commits, classifies changes by impact category, filters internal-only modifications, and produces structured release notes with PR links — following Keep a Changelog conventions.
| references/conventional-commits.md | Commit type parsing, scope extraction, breaking change indicators | Repository uses conventional commits | | references/categorization-rules.md | Change classification logic, audience filtering, severity ordering | Always |
| references/audience-filter.md | User-facing vs internal change detection, exclusion patterns | Always | | references/changelog-formats.md | Keep a Changelog, GitHub Releases, announcement copy templates | Format selection needed |
Generates structured changelogs and release notes from git history and PR descriptions. Classifies changes into breaking, features, fixes, performance, and docs. Filters internal-only changes, detects breaking changes, and produces human-readable entries linked to source PRs. Triggers on: "generate changelog", "write release notes", "compose changelog", "what changed since", "changes since last release", "prepare release", "release notes for", "changelog for", "summarize changes", "diff since tag". Use this skill when preparing a release and needing to summarize changes for users. Source: mathews-tom/praxis-skills.