mcpField
C
changelog

changelog

github.com/motormetricsDevelopment2246 installsUpdated 3d ago
Repository

About changelog

A repository skill describing how release-please creates and publishes a CHANGELOG.md from conventional commits. It helps maintainers understand eligible entries, release pull requests, and how to investigate missing notes.

Key features

  1. 01Maps commit types to changelog sections
  2. 02Explains release-please generation steps
  3. 03Lists commands to inspect release notes
  4. 04Documents checks for missing entries

Use cases

  1. 01Check why a commit is absent from the changelog
  2. 02Preview notes in an open Release PR
  3. 03Find published GitHub Release notes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/motormetrics/motormetrics --skill changelog

After installing, type/changelogin Claude Code to confirm it loaded.

Details

From the project README

Changelog Skill

CHANGELOG.md is generated by release-please as part of each Release PR.

How It Works

  1. release-please runs on push to main
  2. It generates notes from conventional commits since the last release
  3. The notes are prepended to CHANGELOG.md in the open Release PR
  4. Merging the Release PR commits the changelog and publishes the same notes as the GitHub Release

Changelog Sections

Commit types map to changelog sections:

Commit TypeChangelog Section
featFeatures
fixBug Fixes
perfPerformance Improvements
revertReverts
feat! / BREAKING CHANGE⚠ BREAKING CHANGES

Types chore, docs, refactor, test, ci, build and style 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 v5.31.0

# Preview the next entry in the open Release PR
gh pr list --label "autorelease: pending"

Missing Changelog Entry?

  1. Check the commit type: only feat, fix, perf and revert generate entries
  2. Verify the commit landed on main
  3. Check the Release PR has been updated: gh run list --workflow=release.yml
  4. Ensure the commit message follows the conventional format

File Location

  • Changelog: CHANGELOG.md (root of repository)
  • Config: release-please-config.json

Related

  • See release-management skill for release workflow

Comments

Markdown supported