changelog

Generate plugin-scoped changelogs from git commit history.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill changelog-mattbobambrose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog
Source: https://github.com/mattbobambrose/mattbobambrose-claude-skills/tree/main/plugins/project-tools/skills/changelog
Command: npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill changelog-mattbobambrose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Producing accurate, plugin-scoped changelogs from a multi-plugin repository is tedious and error-prone when done manually; this Skill automates extracting, grouping, and summarizing commits so maintainers can produce consistent release notes quickly.

Core Features & Use Cases

  • Commit aggregation by plugin: Maps commits to plugins by inspecting changed file paths under plugins/<name>/ and groups entries per affected plugin.
  • Version-aware grouping: Reads each plugin's plugin.json to include the current version and organizes changelog sections by plugin and version, using conventional commit prefixes where present.
  • Safe updating: Prepends new changelog entries to CHANGELOG.md while preserving existing content and optionally filters commits by tag or date.
  • Use Case: When preparing a release across multiple plugins, run the Skill to generate a single CHANGELOG.md that lists each plugin's new features and fixes since the last release.

Quick Start

Generate a changelog for plugin project-tools including commits since tag v1.0.0 and write the combined entries to CHANGELOG.md.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I generate a changelog from git history for a multi-plugin repository?

Yes, you can scope changelog generation to a single plugin by filtering results to one specific plugin directory. The skill parses git logs and maps changed file paths under plugins/<name>/ to isolate commits relevant to that individual plugin, producing targeted release notes without affecting other plugins.

How do conventional commit prefixes work when grouping changelog entries by version?

Conventional commit prefixes label changelog entries by reading each commit message and categorizing features or fixes accordingly. The skill reads each plugin's plugin.json for version numbers, uses these prefixes to organize entries, and collapses related commits when appropriate to create clean, version-aware sections.

Can I filter git commits by tag or date when generating release notes?

Yes, you can filter git commits by tag or date when generating release notes to scope the changelog to a specific release window. This allows you to summarize only the commits since the last release tag or a specific date, prepending the filtered entries to CHANGELOG.md.

Does prepending new changelog entries to CHANGELOG.md preserve existing content?

Prepending new changelog entries to CHANGELOG.md preserves existing content by inserting new grouped sections at the top of the file. This safe updating mechanism ensures historical release notes remain intact while new plugin-scoped versions and features are added above the previous content.

What is the best way to automate release notes for a multi-plugin repository?

Automating release notes for a multi-plugin repository is best handled by mapping git commit history to plugin directories and grouping entries by version extracted from plugin.json. This approach avoids manual error by automatically scoping changes per plugin and prepending structured entries to your changelog file.