changelog-writing

Converts commits and pull requests into release notes across changelog, store, and advisory surfaces.

2|Updated Sep 6, 2026
One-click install
npx skills add https://github.com/samber/developer-relations-skills --skill changelog-writing-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-writing
Source: https://github.com/samber/developer-relations-skills/tree/main/skills/changelog-writing
Command: npx skills add https://github.com/samber/developer-relations-skills --skill changelog-writing-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing release notes from raw commit history is slow and disliked work, and auto-generated notes are just PR titles in merge order. This Skill turns commits, pull requests, and tickets into scannable release notes that answer the reader's real question: does this release cost me work? ## Core Features & Use Cases - Selection and tiering: Reduces messy history to the net diff, drops changes with no consumer surface, and tiers the release by reader impact to decide which surfaces it earns. - Multi-surface output: Produces CHANGELOG.md entries (Keep a Changelog or Common Changelog), git-host release bodies, hosted pages, in-product notes, app-store text, and enterprise advisories, each within its caps and rules. - Verification gate: Ships every delivery with a traceability table mapping entries to commits, an explicit exclusion list, and open items needing a human, with no unsourced performance numbers. - Use Case: Paste a git log range for a v2.4.0 release and receive specification-conformant changelog entries, a release body with summary paragraph, breaking changes in three-part form, and the list of what was deliberately excluded. ## Quick Start Ask the assistant to write the changelog and release notes for your next version from the commits since the previous tag.

Frequently Asked Questions about changelog-writing

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

FAQPage Schema
How do I write release notes from a messy git history?

Work from the diff and pull-request titles rather than commit subjects, since most repositories have no commit convention. Collapse revert and fixup sequences into the surviving outcome, group changes by feature, and confirm ambiguous groupings with the user before writing entries.

Keep a Changelog vs Common Changelog, which should I use?

Choose Common Changelog for libraries and SDKs whose readers diff versions, since it mandates references and a fixed four-category order. Choose Keep a Changelog for applications and products with mixed audiences, and never rewrite historical releases when switching formats.

How should I write a breaking change entry in a changelog?

Give every breaking entry three parts: what breaks as observable behavior, who it hits as a specific affected subset, and what to do with a migration link when the fix is longer than a rename. Place breaking items first within their category and keep the version number honest.

What is the character limit for Google Play release notes?

Google Play limits release notes to 500 characters per language, enforced on API upload. Write the tightest-capped version first and expand upward, since English typically needs roughly twice the characters of Korean or Japanese for the same meaning.

Can I include a Removed section in a minor version release?

No, a Removed entry inside a minor release is a defect in either the notes or the version number. Major means breaking, minor means additive, and patch means fixes, so removals require a major bump or a prior deprecation announcement.

When should I not use this changelog skill?

Do not use it for version bumping, tagging, or publishing pipelines, which belong to release-automation tooling. Full breaking-change upgrade guides with codemods belong to a migration-guide skill, and narrative launch posts belong to a blog-writing skill.