Changelog Writer

Download SKILL.mdGet Murage How skills work

Open source. macOS, Windows and Linux.

At a glance

What it is

Expert changelog and release notes covering Keep a Changelog format, semantic versioning, conventional commits, automated changelog generation, migration guides, deprecation notices, breaking change communication, and audience-appropriate language.

A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.

File: SKILL.md
Length: 513 lines2,325 words, about 11 min read
Category: Writingtechnical writing
Level: Intermediate
License

More writing skills.

The full skill.

The whole file, exactly as it downloads. Read it before you rely on it.

SKILL.md

513 lines · 2,325 words

Download

Changelog Writer

Overview

This skill provides comprehensive expertise in writing changelogs and release notes that effectively communicate software changes to their intended audiences. It covers the Keep a Changelog standard, semantic versioning alignment, conventional commit conventions, automation tooling, migration guides for breaking changes, deprecation communication, and strategies for writing to different audience levels (developers, end users, stakeholders).

Keep a Changelog Format

Standard Template

markdown

Put this skill to work.

Questions.

What is the Changelog Writer skill?

How much does it cost?

Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.

Can I change it?

Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.

Give your first job to Murage.

Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.

Download Murage

No account needed · Runs on the AI plan you already pay for

Category	Meaning	Example
Added	New features	New API endpoint, new CLI command
Changed	Changes to existing functionality	Default value change, behavior modification
Deprecated	Features marked for future removal	Old API version, legacy parameter
Removed	Features removed in this release	Deleted endpoint, dropped platform support
Fixed	Bug fixes	Corrected calculation, resolved crash
Security	Security-related changes	Vulnerability patches, auth improvements

Commit Type	Changelog Section	Version Bump
`feat:`	Added	MINOR
`fix:`	Fixed	PATCH
`perf:`	Changed (performance)	PATCH
`docs:`	(not in changelog)	None
`style:`	(not in changelog)	None
`refactor:`	(not in changelog)	None
`test:`	(not in changelog)	None
`chore:`	(not in changelog)	None
`ci:`	(not in changelog)	None
Any type with `!` or `BREAKING CHANGE:`	Breaking Changes	MAJOR

Tool	Language	Features
conventional-changelog	Node.js	Git log → CHANGELOG.md
release-please	Node.js	GitHub Action, auto PR for releases
semantic-release	Node.js	Full automation: version, changelog, publish
changesets	Node.js	Monorepo support, manual changeset files
git-cliff	Rust	Configurable, fast, template-based
towncrier	Python	Fragment-based, manual review

Feature	Deprecated In	Alternative
`GET /v2/products?q=`	v2.3.0	`GET /v3/products/search`
`X-API-Key` auth	v2.5.0	OAuth 2.0 Bearer token
`product.category` (string)	v2.1.0	`product.category_id` (UUID)

Changelog Writer

More writing skills.

The full skill.

Changelog Writer

Overview

Keep a Changelog Format

Standard Template

Put this skill to work.

Questions.

Give your first job to Murage.

Search murage.ai

Changelog Writer

More writing skills.

The full skill.

Changelog Writer

Overview

Keep a Changelog Format

Standard Template

Put this skill to work.

Questions.

Give your first job to Murage.

Create a bot and use this skill.

Ask Ember to create the bot

Open the bot’s skills

Find Changelog Writer and switch it on

Ask the bot for the job

About this skill.

Change Categories

Rules for Good Changelog Entries

Semantic Versioning

Version Number Decision Tree

Conventional Commits

Commit Message Format

Commit Types and Changelog Mapping

Examples

Automated Changelog Generation

Tool Comparison

release-please Configuration

Changeset-Based Workflow (Monorepo)

Migration Guides

Migration Guide Template

2. Authentication moved to OAuth 2.0

Deprecation Removal

Rollback Plan

End-User-Facing (App Release Notes)

Stakeholder-Facing (Executive Summary)

Production Checklist

When to Use

Output Format

Example

Edge Cases