repo-changelog

Generate Markdown and Slack-ready release notes from Git diffs.

1|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/Yona544/AIskils --skill repo-changelog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-changelog
Source: https://github.com/Yona544/AIskils/tree/main/ .claude/skills/repo-changelog
Command: npx skills add https://github.com/Yona544/AIskils --skill repo-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Repo-Changelog turns git diffs and commits into end-user friendly release notes, with structured bucketing, breaking-change detection, and Slack-friendly output.

Core Features & Use Cases

  • Diff-based change interpretation with user-friendly language
  • Semantic grouping and consolidation of related changes
  • Slack-ready output and markdown release notes
  • Breaking-change detection and risk assessment
  • Configurability for output, categories, and AI interpretation

Quick Start

Generate release notes between v1.0.0 and v1.1.0 or for the last 100 commits:

  • Command: python3 release-script.py --from v1.0.0 --to v1.1.0

Frequently Asked Questions about repo-changelog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate release notes from Git commits and diffs?

Repo-Changelog generates release notes by analyzing Git diffs between commits or tags, consolidating changes into semantic groups, detecting breaking changes, and producing Markdown or Slack-ready output files in a RELEASE_NOTES directory via a config-driven CLI.

Can I automate changelog generation between specific Git tags?

Yes. Repo-Changelog supports tag-to-tag, since-tag, and last-N-commits modes. Run `python3 release-script.py --from v1.0.0 --to v1.1.0` to generate release notes between specific versions with categorized changes and breaking-change detection.

What output formats does automated changelog generation support?

Repo-Changelog generates timestamped Markdown release notes and Slack-ready output, both with structured bucketing by category, breaking-change flags, and semantic consolidation of related Git changes.

Does changelog automation detect breaking changes in diffs?

Yes. Repo-Changelog analyzes diffs and commits to identify and flag breaking changes with risk assessment, enabling breaking-change detection and categorization alongside standard feature and fix grouping in release notes.

Can I customize categories and output for generated release notes?

Yes. Repo-Changelog is configuration-driven, allowing customization of output categories, AI-based diff interpretation, and consolidation rules to tailor release notes to your repository and audience needs.

Does release-notes automation work across different repository types?

Repo-Changelog applies to cross-platform repositories and works with any Git-based project, supporting flexible input modes and Markdown or Slack output regardless of repository structure or tech stack.