Does it include security update notifications?

Yes, it features a dedicated security section for non-sensitive descriptions of security improvements and required updates.

How does it handle Semantic Versioning?

The skill classifies changes as Major (breaking), Minor (new features), or Patch (bug fixes) to ensure your versioning stays consistent with industry standards.

Does it support OpenAPI specifications?

Yes, it can compare different versions of OpenAPI specifications to identify breaking changes, removed endpoints, and schema modifications.

Can it generate code examples for migrations?

Absolutely. It provides 'before' and 'after' code snippets and specific migration steps to help developers update their client integrations.

What inputs does the skill require?

It can process OpenAPI files, commit messages, pull request descriptions, and issue tracker context to generate a comprehensive log.

API Changelog Generator

Name: API Changelog Generator
Author: Razmik-Kutinava

byRazmik-Kutinava

0•

API開発

Generates comprehensive, developer-friendly API changelogs by analyzing code changes, commit history, and OpenAPI specifications.

This skill transforms Claude into a specialized API technical writer, streamlining the complex task of documenting software updates. It automatically classifies changes according to Semantic Versioning (SemVer) principles, detects breaking changes in OpenAPI specifications, and structures entries into clean, actionable formats. By providing clear migration paths, before-and-after code examples, and security impact summaries, it ensures that API consumers stay informed and can transition between versions with minimal friction and maximum clarity.

主な機能

01Automated breaking change detection through OpenAPI spec comparison

02Multi-environment rollout scheduling and SDK impact assessment

03Standardized templates for features, bug fixes, deprecations, and security updates

04Automatic Semantic Versioning (SemVer) classification for Major, Minor, and Patch updates

05Generation of step-by-step migration guides with realistic code samples

060 GitHub stars

ユースケース

01Generating professional release notes for a major API version upgrade

02Comparing two OpenAPI definitions to identify breaking schema changes for developers

03Creating clear migration instructions and timelines when deprecating legacy endpoints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add razmik-kutinava/test.admin_logistic_v8 api-changelog-generator

For use in Claude.ai and ChatGPT

Download Skill