skills.rest
brayandiazc
brayandiazcCOMMUNITY
Explore all skills by this author →
Website𝕏@brayandiazcGitHub

changelog

Updates CHANGELOG.md in Keep a Changelog format from recent git commits.

15|22|Updated May 5, 2024
Search Tags:#git#changelog#versioning#documentation#release notes#keep a changelog
One-click install
npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill changelog-brayandiazc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: changelog
Source: https://github.com/brayandiazc/project-starter-template-es-ai/tree/main/.claude/skills/changelog
Command: npx skills add https://github.com/brayandiazc/project-starter-template-es-ai --skill changelog-brayandiazc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a changelog accurate and consistent is tedious: developers must review commits, categorize changes, and write user-facing entries in the correct format. This Skill automates that process by generating Keep a Changelog-compliant entries under the Unreleased section. ## Core Features & Use Cases - Automatic Change Detection: Reviews recent commits via git log and the working tree diff to determine what changed since the last version. - Standard Categorization: Organizes entries into Added, Changed, Deprecated, Removed, Fixed, and Security sections, creating only those that apply. - Roadmap Synchronization: Marks the corresponding roadmap item in docs/product/roadmap.md when a change implements a spec, keeping CHANGELOG and roadmap in the same PR. - Use Case: After merging several feature branches, ask the assistant to update the changelog; it inspects the commits, writes concise user-facing bullet points under Unreleased, and links related issues or PRs. ## Quick Start Ask the assistant to update the CHANGELOG with the recent commits since the last release tag.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I update a changelog from git commits automatically?▼

Run git log with the last tag range (git log <last-tag>..HEAD --oneline) to list recent commits, then summarize them into Keep a Changelog categories under the Unreleased section. This Skill performs that review and writes the entries for you.

What is the Keep a Changelog format?▼

Keep a Changelog is a convention that organizes release notes into an Unreleased section plus versioned sections, using categories like Added, Changed, Deprecated, Removed, Fixed, and Security. Entries should be concise and user-facing rather than raw commit messages.

Does this Skill publish or bump version numbers?▼

No. It only adds entries under the Unreleased section and never moves them to a numbered version or increments version numbers unless you explicitly request a release.

Can the changelog update also mark roadmap items as done?▼

Yes. When a change implements a spec, the Skill marks the corresponding roadmap item declared in the spec's proposal.md within docs/product/roadmap.md, keeping the changelog and roadmap in the same pull request.

What happens if the Unreleased section is missing from CHANGELOG.md?▼

The Skill creates the ## [Unreleased] section at the top of the file if it does not exist, then adds the categorized entries beneath it while matching the file's existing style.

Related Skills

Explore More Software Engineering Skills→
multigresmultigres
270

prepare_release

Gather changes since the last git tag, update CHANGELOG.md, and infer the next semantic version.

Official
Advanced
deinsoftwaredeinsoftware
125

swpm-release

Bump SWPM versions in package.json and update CHANGELOG.md from commits.

Official
Advanced
toilahuonggtoilahuongg
10

changelog

Generate Keep a Changelog changelogs from git commits and conventional commit messages.

Community
Intermediate
JuanJoseGonGiJuanJoseGonGi

changelog-generator

Generate user-facing changelogs from git commit history.

Community
Intermediate