Changelog Maintenance

Keeps your project's version history organized using the Keep a Changelog format with semantic versioning. You get templates for both CHANGELOG.md files and release notes that break changes into Added, Changed, Deprecated, Removed, Fixed, and Security sections. The skill includes detailed examples showing how to document breaking changes, migration guides, security patches, and version comparisons. It's especially thorough on the security side, showing how to write CVE disclosures with impact assessments. Good for maintainers who want consistent changelog hygiene without having to remember the format conventions every time they cut a release.

skills.sh installs: 500
GitHub stars: 379
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aj-geddes/useful-ai-prompts --skill changelog-maintenance --agent claude-code

Installs into .claude/skills of the current project.

Files

Changelog Maintenance

Overview

Create and maintain structured changelogs that document all notable changes to your project, following industry best practices like Keep a Changelog and Semantic Versioning.

When to Use

Version history documentation
Release notes generation
Breaking changes tracking
Migration guide creation
Deprecation notices
Security patch documentation
Feature announcements
Bug fix tracking

CHANGELOG.md Template

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- New feature or capability that has been added
- Can be multiple items

### Changed

- Changes in existing functionality
- Updates to how features work

### Deprecated

- Features that will be removed in upcoming releases
- Include timeline for removal

### Removed

- Features that have been removed
- Previously deprecated features

### Fixed

- Bug fixes
- Security patches

### Security

SKILL.md on GitHub