Api changelog summarizer

Skill sisodiabhumca/agent-skills/skills/api-changelog-summarizer

Vendor-neutral skill to convert an API diff (before/after schemas or endpoints) into a structured changelog with breaking changes and migration guidance.From its SKILL.md

Install

npx -y skills add sisodiabhumca/agent-skills --skill api-changelog-summarizer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.2 KB, 222 tokens by cl100k_base, as published. Nobody here has run it

When to invoke

You have an API change (OpenAPI fragments, endpoint lists, or schema diffs) and need a human-readable changelog.
You want release notes with clear breaking vs non-breaking classification.

Inputs needed

A JSON diff describing changes (added/removed/modified endpoints and fields).
Optional release metadata: version, date, owner.

Workflow

Validate diff structure and normalize identifiers.
Classify each change as breaking / behavioral / non-breaking.
Group by endpoint or component.
Generate migration notes (what to update in clients).
Output a Markdown changelog with concise bullets.

Output format

Markdown with:

Release header
Breaking changes
Behavioral changes
Non-breaking changes
Deprecations
Migration notes

Guardrails

If the diff does not include enough information to classify a change, mark it as "needs review".
Do not invent endpoints or fields.

Reference code

summarize_api_diff.py reads a JSON diff and writes Markdown changelog.

What ships with it: 3 files

10.2 KB alongside SKILL.md, 2 of them executable