Api Changelog Versioning

This generates structured API changelogs with migration guides when you're shipping breaking changes or deprecating endpoints. It templates out version announcements with before/after code examples, deprecation timelines, and step-by-step migration paths. The format is straightforward: breaking changes up top, support policy in a table, and actual code diffs showing what developers need to change. Useful if you're maintaining multiple API versions and need to communicate what's changing without leaving your users guessing. The three to six month deprecation window it suggests is reasonable, and the emphasis on concrete examples over vague notices is the right approach.

skills.sh installs: 415
GitHub stars: 248
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add secondsky/claude-skills --skill api-changelog-versioning --agent claude-code

Installs into .claude/skills of the current project.

Files

API Changelog & Versioning

Document API changes with clear migration paths and deprecation timelines.

Changelog Structure

# API Changelog

## v3.0.0 (2025-01-15) - Breaking Changes

### Breaking Changes
- Response format now follows JSON:API specification
- Authentication switched from API tokens to JWT Bearer

### Migration Steps
1. Update base URL to `/api/v3`
2. Replace `Authorization: Token xxx` with `Authorization: Bearer xxx`
3. Update response parsing for new envelope format

## v2.5.0 (2024-12-01) - Features

### New Features
- Webhook support for order events
- Batch operations endpoint
- Field filtering via `?fields=` parameter

### Improvements
- 56% faster response times on /products
- Enhanced error messages with field-specific suggestions