How do I install the Changelog skill?

Run npx skillmds@latest add motormetrics/changelog 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.

What does the Changelog skill do?

Understand auto-generated changelogs via semantic-release. Use when viewing release history, understanding changelog format, or debugging missing changelog entries. It is listed under Coding & Dev Tools on SkillMD.

Is Changelog safe to use?

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

Which AI agents work with Changelog?

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 Changelog free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Changelog?

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

Changelog by motormetrics — Agent Skill

Name: Changelog
Author: motormetrics

File contents

Changelog Skill

Changelogs are auto-generated by @semantic-release/changelog on each release.

How It Works

semantic-release runs on push to main
@semantic-release/release-notes-generator generates notes from commits (conventionalcommits preset)
@semantic-release/changelog prepends notes to CHANGELOG.md
@semantic-release/git commits the updated changelog

Changelog Sections

Commit types map to changelog sections:

Commit Type	Changelog Section
`feat`	Features
`fix`	Bug Fixes
`perf`	Performance Improvements
`revert`	Reverts
`feat!` / `BREAKING CHANGE`	BREAKING CHANGES

Types chore, docs, refactor, test, ci do not appear in the changelog.

Viewing Changelog

# View the changelog file
cat CHANGELOG.md

# View a specific GitHub release's notes
gh release view v4.46.0

# List recent releases with dates
gh release list --limit 10

Missing Changelog Entry?

If a commit does not appear in the changelog:

Check the commit type — only feat, fix, perf, revert generate entries
Verify the commit landed on main (not a feature branch)
Check if semantic-release ran: gh run list --workflow=release.yml
Ensure commit message follows conventional format

File Location

Changelog: CHANGELOG.md (root of repository)
Config: .releaserc.json → @semantic-release/changelog plugin

See conventional-commits skill for commit message format
See release-management skill for release workflow

Frequently asked questions

Changelog