api-changelog-versioning
Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.
npx skills add majiayu000/claude-skill-registry --skill api-changelog-versioning --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# API Changelog & Versioning Document API changes with clear migration paths and deprecation timelines. ## Changelog Structure ```markdown # 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 ``` ## Deprecation Schedule | Version | Status | Support Until | |---------|--------|---------------| | v3.x | Current | Full support | | v2.x | Maintenance | 2025-06-01 | | v1.x | EOL | Unsupported | ## Version Support Policy - **Current**: Full support, new features - **Maintenance**: Bug fixes and security only - **EOL**: No support, remove from docs ## Migration Guide Template ```markdown ## Migrating from v2 to v3 ###
- Changelog Structure
- Deprecation Schedule
- Version Support Policy
- Migration Guide Template
- Best Practices
What does the api-changelog-versioning skill do?
Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-changelog-versioning --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.