om-auto-update-changelog

Drafts a CHANGELOG.md release entry from merged PRs and ships it as a docs PR.

2.6k|159|Updated Mar 8, 2021
One-click install
npx skills add https://github.com/go-musicfox/go-musicfox --skill om-auto-update-changelog-go-musicfox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-auto-update-changelog
Source: https://github.com/go-musicfox/go-musicfox/tree/main/.agents/skills/om-auto-update-changelog
Command: npx skills add https://github.com/go-musicfox/go-musicfox --skill om-auto-update-changelog-go-musicfox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing release changelogs by hand means manually reviewing every merged PR since the last release, categorizing each one, and figuring out who actually deserves credit — a process that is tedious and frequently misattributes work to whoever pressed merge rather than who wrote the code. ## Core Features & Use Cases - Automated release window enumeration: Builds the set of merged PRs from git reachability against the release ref, with pagination detection and exclusions for plumbing PRs, so no shipped work is silently omitted. - Emoji-driven categorized entries: Classifies each PR by labels or conventional-commit prefixes into sections like Features, Fixes, Security, and CI/CD, matching the repo's existing CHANGELOG.md format when one exists. - Supersede Credit Rule with verification: Resolves the true author through five detection paths (carry-forward templates, umbrella merges, free-text attribution) and verifies every credit against commit authorship, never crediting bots or AI agents. - PR delegation: Hands the finished entry to the om-auto-create-pr skill, which opens it as a docs-only PR with labels and a review pass. - Use Case: Before cutting release 0.4.11, run the skill to compile every PR merged since 0.4.10 into a formatted CHANGELOG.md entry with correct contributor credits, then review the resulting docs PR before merge. ## Quick Start Ask the agent to draft a changelog entry for the next release covering all PRs merged since the last release, optionally passing a version number or using --dry-run to preview the entry without changing any files.

Frequently Asked Questions about om-auto-update-changelog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a changelog from merged pull requests automatically?

Run the skill at release time; it enumerates merged PRs since the last release using git reachability from the release ref, categorizes each by labels or conventional-commit prefixes, and prepends a formatted entry to CHANGELOG.md. The entry is then shipped as a docs PR via the om-auto-create-pr skill.

How does the changelog credit the right author for carried-forward PRs?

The Supersede Credit Rule checks five detection paths, including Supersedes and Credit templates in PR bodies, closing comments on superseded PRs, umbrella merge commit tallies, and free-text attribution. Every credit is then verified against actual commit authorship before the entry ships.

Can I preview the changelog entry without modifying any files?

Yes, pass --dry-run to compute the full entry in memory and print it with a per-PR audit table showing category, emoji, credited author, and verification status. No file edits are made and no PR is created in dry-run mode.

Does it work when releases are cut from a different branch than PRs target?

Yes, use --release-ref to specify the branch the release is cut from. The window is built from git reachability on that ref rather than a baseRefName filter, which avoids listing unshipped work or missing PRs that landed with the cut.

What happens if a changelog PR for the same version already exists?

The run stops and asks the user rather than forcing a duplicate. The skill never passes --force to om-auto-create-pr, so an existing changelog PR for the same version is treated as a conflict requiring human decision.

Why are bot accounts and AI agents missing from the Contributors list?

The skill maintains a never-credited identity list covering bot accounts like dependabot and renovate plus AI coding agents such as copilot and codex. When a PR's credit resolves only to excluded identities, the bullet ships with no author suffix at all.