skills.rest
product-on-purpose
product-on-purposeOFFICIAL
Explore all skills by this author →
GitHub

utility-pm-changelog-curator

Drafts CHANGELOG entries from git log between tags with hygiene rules and layered status output.

640|81|Updated Jan 9, 2026
Search Tags:#release management#release notes#Keep-a-Changelog#git log#version tagging#sub-agent dispatch#ChangeLog
One-click install
npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-changelog-curator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: utility-pm-changelog-curator
Source: https://github.com/product-on-purpose/pm-skills/tree/main/skills/utility-pm-changelog-curator
Command: npx skills add https://github.com/product-on-purpose/pm-skills --skill utility-pm-changelog-curator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Writing CHANGELOG entries by hand from raw git history is tedious and error-prone, especially when a repo enforces specific hygiene rules like public paths only, no attribution trailers, and Keep-a-Changelog section ordering. This Skill automates the drafting step so maintainers get a review-ready draft instead of a blank page.

Core Features & Use Cases

  • Git-log-driven drafting: Enumerates commits between two tags, classifies them, groups them into Added, Changed, Fixed, Security, and other Keep-a-Changelog sections, and rewrites them per repo hygiene rules.
  • Cross-client dispatch: Runs as a native sub-agent on Claude Code and executes the same 8-step flow inline on Codex CLI, Cursor, Windsurf, Copilot, and Gemini CLI.
  • Layered review output: Returns a full CHANGELOG draft with hidden justification comments, a prose Status Summary, and a machine-parseable Status YAML block for parent tooling like a release conductor.
  • Use Case: Before tagging v2.16.0, ask for a CHANGELOG draft since v2.15.2; the Skill processes 50 commits, produces grouped entries with justification comments, and flags a dirty working tree unless --committed-only is passed.

Quick Start

Ask the AI to draft CHANGELOG entries from the git log since the last tag for the upcoming release version.

Frequently Asked Questions about utility-pm-changelog-curator

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

FAQPage Schema
How do I draft a CHANGELOG from git log automatically?▼

Invoke the skill with a since tag and target version, and it enumerates commits in that range, classifies them into Keep-a-Changelog sections, and rewrites them per the repo's hygiene rules. The output is a review-ready draft, not a commit.

How to generate CHANGELOG entries on Cursor or Windsurf without a Claude sub-agent?▼

The dispatch skill detects the non-Claude client, reads the canonical sub-agent definition at agents/pm-changelog-curator.md, and executes the same 8-step drafting flow inline. Output is structurally identical to the native Claude Code sub-agent.

Does the changelog curator commit entries directly to CHANGELOG.md?▼

No, it produces a draft for maintainer review only. Hidden justification comments are included for audit and must be stripped before the final commit, which the release conductor handles when chained.

What happens if the working tree has uncommitted changes?▼

The skill refuses to draft by default when the working tree is dirty. Pass --committed-only to draft strictly from committed history, in which case a dirty_tree_warning flag is set in the Status YAML.

When should I use the release conductor instead of the changelog curator?▼

Use the changelog curator when you only need the CHANGELOG drafting step. Use the release conductor for the full guided 6-gate release flow, which chains to this skill automatically at gate G2.

Related Skills

Explore More Product & Management Skills→
silversteinsilverstein
1.5k

minutes-release-notes

Draft user-facing release notes for Minutes versions from git commit ranges and GitHub releases.

Community
Intermediate
t0labt0lab
2

release

Analyze Conventional Commits to draft changelogs and create release commits and tags.

Official
Advanced
yandy-ryandy-r

releaser

Draft changelogs and emit git/tag/gh commands for release planning.

Community
Advanced
harperreedharperreed
330

app-store-changelog

Generate App Store release notes from git history since the last tag.

Community
Intermediate