changelog-generator

Installation
SKILL.md

Changelog Generator Protocol

This skill bridges the gap between raw git history and consumer-facing API updates. Consumers don't care about "Refactored user service;" they care about "The /users endpoint now returns a profile_pic URL."

Core assumption: A changelog is a communication tool, not a git dump. It must focus on the API interface, not internal implementation tweaks.


1. Input Analysis (Static)

Parse the provided text (Git commits, PR bodies, or OpenAPI diffs) and filter out internal noise.

  • Keep: Added fields, new endpoints, deprecated endpoints, bug fixes that changed API behavior.
  • Discard: Dependency updates, CI/CD tweaks, internal refactoring (unless it drastically improved performance).

2. Categorization & Formatting

Organize the update into established categories:

  • 🚀 Features: New capabilities for the consumer.
  • 🛠️ Fixes: Resolved behavior issues.
  • ⚠️ Deprecations: Warnings about endpoints/fields being sunset.
  • 🚨 BREAKING CHANGES: Red-alert items requiring consumer code updates. (Cross-reference findings with breaking-change-detector).
Related skills

More from fatih-developer/fth-skills

Installs
2
GitHub Stars
4
First Seen
Mar 3, 2026