Agent skill · writing content · aj-geddes
changelog-maintenance
Maintain comprehensive changelogs and release notes following Keep a Changelog format. Use when documenting version history, release notes, or tracking changes across versions.
Why this skill is useful
Codifies a structured approach to changelog maintenance that the AI could infer but now doesn't have to guess.
What it needs
About 7k tokens when loaded. Last updated 2026-03-04. 307 stars on the source repository.
What this skill does
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 javascript // Old (v1) fetch("/api/users/list") .then((res) => res.text()) .then((xml) => parseXML(xml)); // New (v2) fetch("/api/v2/users") .then((res) => res.json()) .then((data) => console.log(data)); 3. Run database migrations: 4. Update environment variables: [1.5.2] - 2024-12-15 Fixed Fixed pagination bug on user list page Resolved timezone issues in reports Fixed email notification delays [1.5.0] - 2024-12-01 Added New reporting dashboard Custom fields for user profiles Webhook support for integrations Changed Improved search performance Updated UI components library [1.0.0] - 2024-10-01 Added Initial release User management Basic API Authentication and authorization Database migrations Unit and integration tests [Unreleased]: https://github.com/user/repo/compare/v2.1.0...HEAD [2.1.0]: https://github.com/user/repo/compare/v2.0.5...v2.1.0 [2.0.5]: https://github.com/user/repo/compare/v2.0.0...v2.0.5 [2.0.0]: https://github.com/user/repo/compare/v1.5.2...v2.0.0 [1.5.2]: https://github.com/user/repo/compare/v1.5.0...v1.5.2 [1.5.0]: https://github.com/user/repo/compare/v1.0.0...v1.5.0 [1.0.0]: https://github.com/user/repo/releases/tag/v1.0.0 markdown Release Notes - Version 2.1.0 Release Date: January 15, 2025 Download: v2.1.0 🎉 Highlights OAuth2 Authentication: Sign in with GitHub and Google GraphQL API: New GraphQL endpoint alongside REST API Dark Mode: Full dark mode support across all pages Real-time Notifications: WebSocket-powered live updates 10 New Languages: Expanded internationalization support 📦 What's New OAuth2 Authenticati …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aj-geddes/changelog-maintenance