write-changelog-entry

Generate a new CHANGELOG.md release entry from merged pull requests and commits.

2|Updated May 2, 2026
One-click install
npx skills add https://github.com/andrecini/dotnet-squad-copilot-agent --skill write-changelog-entry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-changelog-entry
Source: https://github.com/andrecini/dotnet-squad-copilot-agent/tree/main/.claude/skills/write-changelog-entry
Command: npx skills add https://github.com/andrecini/dotnet-squad-copilot-agent --skill write-changelog-entry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the manual effort and inconsistency of writing release notes by automatically compiling what changed since the last release into the correct CHANGELOG section.

Core Features & Use Cases

  • Automatic release-diff from the last tag by gathering merged PRs and commits, then grouping them into changelog categories.
  • Semantic version suggestion by classifying changes (feat/fix/perf/refactor/test/chore/docs) and proposing the appropriate vMAJOR.MINOR.PATCH.
  • Safe, targeted file update that inserts a new entry directly under the Unreleased section in CHANGELOG.md while preserving all existing content.

Quick Start

Use the skill to update the changelog by asking: "Atualiza o CHANGELOG.md com a nova release, sugerindo a versão e confirmando antes de aplicar."

Frequently Asked Questions about write-changelog-entry

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

FAQPage Schema
How do I automatically generate release notes from merged pull requests?

You can generate release notes by compiling merged pull requests and commits since the last release tag, grouping them into changelog categories, and inserting the new entry under the [Unreleased] section in CHANGELOG.md.

How does semantic versioning work when updating a changelog?

Semantic versioning is applied by classifying changes into feat, fix, perf, refactor, test, chore, or docs categories, then proposing the appropriate vMAJOR.MINOR.PATCH increment based on the highest impact change type found.

Can I update CHANGELOG.md without overwriting existing release entries?

Yes, you can safely update CHANGELOG.md by inserting the new release entry directly under the Unreleased section while preserving all existing content and never modifying previously documented releases.

What is the best way to suggest a version number for a new changelog entry?

The best way to suggest a version number is by analyzing the git log for conventional commit types like feat or fix, classifying the changes, and proposing a semantic version bump that requires explicit confirmation before applying.

Does generating a changelog entry require explicit version confirmation before applying?

Yes, generating a changelog entry requires explicit version confirmation before applying the update, ensuring the proposed semantic version is reviewed and approved prior to modifying the CHANGELOG.md file.

Why does the changelog generator ignore style and revert changes?

The changelog generator ignores style and revert changes to maintain a concise, user-facing release history, filtering out non-functional modifications that do not impact the semantic versioning classification or end users.