Agent skill · writing content · aiskillstore
changelog-maintenance
Maintain a clear and informative changelog for software releases. Use when documenting version changes, tracking features, or communicating updates to users. Handles semantic versioning, changelog formats, and release notes.
Why this skill is useful
Codifies a standard changelog format and semantic versioning practices that the AI could infer but now doesn't have to guess.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Changelog Maintenance When to use this skill Before release: organize changes before shipping a version Continuous: update whenever significant changes occur Migration guide: document breaking changes Instructions Step 1: Keep a Changelog format CHANGELOG.md: Step 2: Semantic Versioning Version number: MAJOR.MINOR.PATCH Examples: 1.0.0 → 1.0.1: bug fix 1.0.1 → 1.1.0: new feature 1.1.0 → 2.0.0: Breaking change Step 3: Release Notes (user-friendly) Step 4: Breaking Changes migration guide Output format Constraints Required rules (MUST) 1. Reverse chronological: latest version at the top 2. Include dates: ISO 8601 format (YYYY-MM-DD) 3. Categorize entries: Added, Changed, Fixed, etc. Prohibited items (MUST NOT) 1. No copying Git logs: write from the user's perspective 2. Vague wording: "Bug fixes", "Performance improvements" (be specific) Best practices 1. Keep a Changelog: follow the standard format 2. Semantic Versioning: consistent version management 3. Breaking Changes: provide a migration guide References Keep a Changelog Semantic Versioning Metadata Version Current version: 1.0.0 Last updated: 2025-01-01 Compatible platforms: Claude, ChatGPT, Gemini Tags #changelog #release-notes #versioning #semantic-versioning #documentation Examples Example 1: Basic usage <!-- Add example content here --> Example 2: Advanced usage <!-- Add advanced example content here -->
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/changelog-maintenance