How do I install the Utility Pm Changelog Curator skill?

Run npx skillmds add product-on-purpose/utility-pm-changelog-curator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Utility Pm Changelog Curator safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Utility Pm Changelog Curator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Utility Pm Changelog Curator free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Utility Pm Changelog Curator?

product-on-purpose (@product-on-purpose) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Utility Pm Changelog Curator by product-on-purpose

Name: Utility Pm Changelog Curator
Rating: 4.5 (4 reviews)
Author: product-on-purpose

Utility Pm Changelog Curator

Draft CHANGELOG entries from git log via the pm-changelog-curator sub-agent, applying the repo hygiene rules (describe what changed, public paths only, no attribution trailers). Returns a layered draft with a status summary for maintainer review; refuses a dirty working tree unless --committed-only is passed. Use when banking unreleased changes or preparing a release.

product-on-purpose 2f94589 5 files · 18.7 KB Updated Sep 9, 2026

File contents

PM Changelog Curator (Dispatch Skill)

Cross-client dispatch wrapper for the pm-changelog-curator sub-agent. Detects runtime; dispatches to the native sub-agent on Claude Code; reads agents/pm-changelog-curator.md and executes inline on non-Claude clients.

When to Use

You are preparing a release and want a CHANGELOG draft from git log between two tags
You are running on a non-Claude AI client without native pm-changelog-curator sub-agent support
You want a draft that respects pm-skills CHANGELOG hygiene rules (no internal-notes references, no em-dashes, public paths only) without manually applying them

When NOT to Use

You want to commit CHANGELOG entries directly (this skill produces a draft for review, not a commit)
You want to review a PM artifact -> use utility-pm-critic instead
You want a repo-wide governance audit -> use utility-pm-skill-auditor
You want a full guided release flow -> use utility-pm-release-conductor (which chains to this skill at gate G2)

Instructions

Runtime detection step. Determine which AI client is invoking this skill.

If you are running in Claude Code with the pm-skills plugin installed

Invoke @agent-pm-skills:pm-changelog-curator with the user's arguments. Pass --since-tag, --target-version, --committed-only from $ARGUMENTS if present. Return the sub-agent's draft to the user.

If you are running in any other AI client

Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, or any other client without native pm-skills plugin sub-agent support:

Read the canonical sub-agent definition at agents/pm-changelog-curator.md
Execute the system prompt body in that file as your operating instructions
Run the 8-step drafting flow documented in the sub-agent definition (establish range -> read hygiene rules -> check working tree -> enumerate commits -> classify -> group -> rewrite -> determine target version -> emit draft)
Apply --since-tag, --target-version, and --committed-only arguments from $ARGUMENTS
Return the layered output per master plan D26 (full CHANGELOG draft + Status Summary + Status YAML)

Cross-Client Notes

The dispatch skill requires the AI client to:

Execute Bash for git log, git describe, and git status invocations
Read CLAUDE.md hygiene rules and existing CHANGELOG.md format reference
Read the canonical sub-agent definition file
Treat the agent body as operating instructions

See Sub-Agent Compatibility Matrix for the canonical cross-client status. Summary for this skill as of v2.16.0: PRODUCTION on Claude Code + Codex CLI (Codex CLI successfully ran git log + read CLAUDE.md hygiene rules + drafted clean CHANGELOG entries + correct dirty-tree refusal); EXPERIMENTAL on Cursor / Windsurf / Copilot CLI / Gemini CLI. If a client is unreliable, fall back to manual git log + manual drafting using CLAUDE.md as the hygiene reference.

Reference Files

Canonical sub-agent definition: agents/pm-changelog-curator.md
Behavioral spec: docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md
CHANGELOG hygiene rules source: CLAUDE.md (repo root)
Existing CHANGELOG.md format: CHANGELOG.md (root); v2.15.1 + v2.15.2 entries are canonical exemplars
Runtime components catalog: docs/reference/runtime-components.md
Output template: references/TEMPLATE.md
Worked example: references/EXAMPLE.md

---name: utility-pm-changelog-curatordescription: Draft CHANGELOG entries from git log via the pm-changelog-curator sub-agent, applying the repo hygiene rules (describe what changed, public paths only, no attribution trailers). Returns a layered draft with a status summary for maintainer review; refuses a dirty working tree unless --committed-only is passed. Use when banking unreleased changes or preparing a release.license: Apache-2.0--- # PM Changelog Curator (Dispatch Skill) Cross-client dispatch wrapper for the `pm-changelog-curator` sub-agent. Detects runtime; dispatches to the native sub-agent on Claude Code; reads `agents/pm-changelog-curator.md` and executes inline on non-Claude clients. ## When to Use - You are preparing a release and want a CHANGELOG draft from git log between two tags - You are running on a non-Claude AI client without native pm-changelog-curator sub-agent support - You want a draft that respects pm-skills CHANGELOG hygiene rules (no internal-notes references, no em-dashes, public paths only) without manually applying them ## When NOT to Use - You want to commit CHANGELOG entries directly (this skill produces a draft for review, not a commit) - You want to review a PM artifact -> use `utility-pm-critic` instead - You want a repo-wide governance audit -> use `utility-pm-skill-auditor` - You want a full guided release flow -> use `utility-pm-release-conductor` (which chains to this skill at gate G2) ## Instructions **Runtime detection step.** Determine which AI client is invoking this skill. ### If you are running in Claude Code with the pm-skills plugin installed Invoke `@agent-pm-skills:pm-changelog-curator` with the user's arguments. Pass `--since-tag`, `--target-version`, `--committed-only` from `$ARGUMENTS` if present. Return the sub-agent's draft to the user. ### If you are running in any other AI client Codex CLI, Cursor, Windsurf, Copilot, Gemini CLI, or any other client without native pm-skills plugin sub-agent support: 1. Read the canonical sub-agent definition at `agents/pm-changelog-curator.md` 2. Execute the system prompt body in that file as your operating instructions 3. Run the 8-step drafting flow documented in the sub-agent definition (establish range -> read hygiene rules -> check working tree -> enumerate commits -> classify -> group -> rewrite -> determine target version -> emit draft) 4. Apply `--since-tag`, `--target-version`, and `--committed-only` arguments from `$ARGUMENTS` 5. Return the layered output per master plan D26 (full CHANGELOG draft + Status Summary + Status YAML) ## Cross-Client Notes The dispatch skill requires the AI client to: 1. Execute Bash for `git log`, `git describe`, and `git status` invocations 2. Read CLAUDE.md hygiene rules and existing CHANGELOG.md format reference 3. Read the canonical sub-agent definition file 4. Treat the agent body as operating instructions See [Sub-Agent Compatibility Matrix](../../docs/reference/sub-agent-compatibility.md) for the canonical cross-client status. Summary for this skill as of v2.16.0: PRODUCTION on Claude Code + Codex CLI (Codex CLI successfully ran git log + read CLAUDE.md hygiene rules + drafted clean CHANGELOG entries + correct dirty-tree refusal); EXPERIMENTAL on Cursor / Windsurf / Copilot CLI / Gemini CLI. If a client is unreliable, fall back to manual `git log` + manual drafting using CLAUDE.md as the hygiene reference. ## Reference Files - Canonical sub-agent definition: [`agents/pm-changelog-curator.md`](../../agents/pm-changelog-curator.md) - Behavioral spec: [`docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md`](../../docs/internal/release-plans/v2.16.0/spec_pm-changelog-curator.md) - CHANGELOG hygiene rules source: `CLAUDE.md` (repo root) - Existing CHANGELOG.md format: `CHANGELOG.md` (root); v2.15.1 + v2.15.2 entries are canonical exemplars - Runtime components catalog: [`docs/reference/runtime-components.md`](../../docs/reference/runtime-components.md) - Output template: `references/TEMPLATE.md` - Worked example: `references/EXAMPLE.md`

Frequently asked questions