Communitygithub.com

Changelog Generator

Automatisch benutzerfreundliche Changelogs aus der Git-Historie generieren. Folgt dem Keep a Changelog-Format, poliert Commit-Nachrichten in eine benutzerfreundliche Sprache und erstellt optional GitHub Releases.

Was ist Changelog Generator?

Das Skill **Changelog Generator** ermöglicht es, automatisch und menschlich lesbare Changelogs aus einem Git-Repository zu erstellen. Es unterstützt mehrere Eingabeformate: einen Git-Ref-Bereich (z.B. `v1.0.0...v1.1.0`), einen einzelnen Tag (alle Änderungen seit diesem Tag bis HEAD) oder eine Pull-Request-URL/Nummer, um nur die Änderungen dieses PRs zu verwenden. Der Generator befolgt das verbreitete Keep a Changelog-Format, kategorisiert Änderungen in Abschnitte wie Added, Fixed, Changed und Breaking Changes und poliert jede Commit-Nachricht in eine benutzerfreundliche, ergebnisorientierte Sprache um (z.B. „Berichte laden jetzt 3× schneller“ statt „SQL-Abfrageplan optimiert“). Der Workflow besteht aus fünf Phasen: Eingabe auflösen, Änderungen sammeln, kategorisieren, polieren und zur Überprüfung präsentieren. Erst nach Benutzerbestätigung wird das Changelog in die vorhandene `CHANGELOG.md` eingefügt und optional ein GitHub Release erstellt. Das Skill ist besonders nützlich für Release-Manager, Entwickler-Teams und Open-Source-Maintainer, die schnell und konsistent Release-Notes aus Git-Commits und Pull-Requests erstellen möchten. Es funktioniert plattformunabhängig in jedem Git-Repository mit `gh`-Unterstützung für PR-Erkennung und GitHub Releases.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/changelog

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Changelog Generator?

Automatisch benutzerfreundliche Changelogs aus der Git-Historie generieren. Folgt dem Keep a Changelog-Format, poliert Commit-Nachrichten in eine benutzerfreundliche Sprache und erstellt optional GitHub Releases.

Eingabeauflösung

Die primäre Eingabe ist ein Git-Ref-Bereich. Löse das Argument (falls angegeben) folgendermaßen auf:

  1. Enthält ... oder .. -> Git-Ref-Bereich (z.B. v1.0.0...v1.1.0)
  2. Passt zu einem einzelnen Tag/Ref -> von jenem Ref bis HEAD
  3. Passt zu einer GitHub-URL oder einem #\d+-Muster -> PR (nur Änderungen aus diesem PR extrahieren). Bei Einzel-PR-Eingabe: Lies den PR-Diff und die Beschreibung, kategorisiere die Änderungen, verwende den PR-Titel als Eintrag. Überspringe den Versions-Header. Frage den Benutzer, ob diese Einträge an eine vorhandene Changelog-Version angehängt oder eine neue erstellt werden soll.
  4. Kein Argument -> frage: „Welchen Bereich soll der Changelog abdecken? Du kannst einen Git-Ref-Bereich (z.B. v1.0.0...v1.1.0), einen Tag (Änderungen seit diesem Tag) oder eine PR-Nummer angeben.“

Prozessablauf

digraph changelog {
    rankdir=TB;
    "Eingabe auflösen" [shape=box];
    "Phase 1: Sammeln" [shape=box];
    "Phase 2: Kategorisieren" [shape=box];
    "Phase 3: Polieren" [shape=box];
    "Phase 4: Überprüfen" [shape=box];
    "Bestätigt?" [shape=diamond];
    "Phase 5: Ausgabe" [shape=box];

    "Eingabe auflösen" -> "Phase 1: Sammeln";
    "Phase 1: Sammeln" -> "Phase 2: Kategorisieren";
    "Phase 2: Kategorisieren" -> "Phase 3: Polieren";
    "Phase 3: Polieren" -> "Phase 4: Überprüfen";
    "Phase 4: Überprüfen" -> "Bestätigt?";
    "Bestätigt?" -> "Phase 3: Polieren" [label="Überarbeitungen"];
    "Bestätigt?" -> "Phase 5: Ausgabe" [label="Ja"];
}

Überspringe keine Phasen. Stelle Fragen in einem natürlichen Tempo. Wenn der Benutzer mehrere auf einmal beantwortet, akzeptiere gebündelte Antworten und springe vorwärts.

Wenn der Benutzer „wähle einfach Standardeinstellungen“ oder ähnliches sagt, wähle vernünftige Standardeinstellungen, teile mit, was du gewählt hast, und bitte um eine einzige Bestätigung.

Phase 1: Sammeln

Schritt 1 – Commits und PRs sammeln

Führe git log zwischen den beiden Ref-Punkten aus, um alle Commits zu sammeln. Wenn das Repository PRs verwendet, suche auch nach gemergten PRs im Bereich mit gh pr list --state merged.

Extrahiere für jeden Commit/PR:

  • Commit-Nachricht (Betreff + Textkörper)
  • Geänderte Dateien (zur Bestimmung des Umfangs)
  • PR-Titel und -Beschreibung (falls verfügbar)
  • Jegliches Prefix für konventionelle Commit-Typen (feat, fix, chore, usw.)

Schritt 2 – Weiteren Produktkontext lesen

Lese, falls vorhanden: README, package.json (oder Äquivalent). Ziel: verstehen, was das Produkt ist, um benutzerfreundliche Beschreibungen zu schreiben.

Wenn nichts gefunden wird, frage: „Kannst du das Produkt kurz beschreiben? Ich brauche Kontext, um benutzerfreundliche Changelog-Einträge zu schreiben.“

Schritt 3 – Vorhandenes Format erkennen

Überprüfe, ob das Repository eine vorhandene CHANGELOG.md hat. Wenn ja:

  • Erkenne das Format (Keep a Changelog, benutzerdefiniert, usw.)
  • Erkenne, ob Emoji-Labels (z.B. Emojis für Neu, Bug-Fix, Breaking) oder reine Textkategorien verwendet werden
  • Passe dich dem vorhandenen Stil an

Wenn kein vorhandener Changelog:

  • Standardmäßig das Keep a Changelog-Format verwenden
  • Frage: „Kein vorhandener Changelog gefunden. Bevorzugst du Emoji-Labels (z.B. für Neu, Bug-Fix) oder reine Textkategorien (Hinzugefügt, Behoben, usw.)?“

Phase 2: Kategorisieren

Sortiere alle Änderungen in Keep a Changelog-Kategorien. Breaking Changes erhalten einen eigenen Abschnitt ganz oben:

  • Breaking Changes – jede Änderung, die bestehendes Verhalten, APIs bricht oder eine Benutzeraktion zum Upgrade erfordert. Füge für jede eine Migrationsanleitung hinzu. Erkenne an feat!:, fix!:, BREAKING CHANGE:-Fußzeilen oder entfernten/umbenannten APIs im Diff.
  • Hinzugefügt – neue Funktionen
  • Geändert – Änderungen an bestehender Funktionalität
  • Veraltet – Funktionen, die entfernt werden
  • Entfernt – Funktionen, die entfernt wurden
  • Behoben – Bug-Fixes
  • Sicherheit – Schwachstellenbehebungen

Kategorisierungsregeln:

  • Folgen Commits konventionellen Commits (feat:, fix:, usw.), verwende den Typ zur Kategorisierung
  • Wenn nicht, analysiere den Diff und die Commit-Nachricht, um die Kategorie zu bestimmen
  • Überspringe reine Interne-Änderungen (Refactorings, Test-Ergänzungen, CI-Änderungen, Abhängigkeits-Upgrades), sofern sie das benutzerseitige Verhalten nicht beeinflussen
  • Bei Unsicherheit, ob eine Änderung benutzerseitig ist, nimm sie auf und lass den Benutzer sie bei der Überprüfung entfernen
  • Für Bereiche mit 50+ Commits fasse zusammenhängende Änderungen zu übergeordneten Einträgen zusammen (z.B. statt 12 einzelner API-Fixes schreibe „Verbesserte API-Fehlerbehandlung über mehrere Endpunkte hinweg“). Präsentiere die zusammengefasste Version und lass den Benutzer jede Gruppe erweitern, wenn er Details wünscht.

Präsentiere die kategorisierte Liste:

„Hier ist, was ich in diesem Bereich gefunden habe:“

Hinzugefügt (3)

  • Funktion A
  • Funktion B
  • Funktion C

Behoben (2)

  • Bug-Fix A
  • Bug-Fix B

„Möchtest du etwas hinzufügen, entfernen oder umkategorisieren?“

Fahre NICHT fort, bis der Benutzer bestätigt.

Phase 3: Polieren

Schreibe jeden Eintrag in benutzerfreundliche Sprache um:

  • Beginne mit dem Nutzen für den Benutzer, nicht mit dem Implementierungsdetail
  • „Berichte laden jetzt 3× schneller“, nicht „Optimierter SQL-Abfrage-Ausführungsplan für das Berichtsmodul“
  • „Du kannst Berichte jetzt als PDF exportieren“, nicht „PDF-Export-Funktionalität zum Berichtsdienst hinzugefügt“
  • Halte jeden Eintrag auf eine Zeile (maximal zwei für komplexe Änderungen)
  • Füge PR/Issue-Referenzen ein, wo verfügbar (z.B. (#123))

Versions-Header

Format: ## [Version] - YYYY-MM-DD

Wenn die obere Grenze des Bereichs ein Versions-Tag ist (z.B. v1.2.0), verwende dies als Version. Wenn die obere Grenze HEAD oder ein Branchname ist, frage: „Welche Versionsnummer soll dieser Changelog verwenden?“

Verwende das Datum des jüngsten Commits im Bereich, im ISO-Format (YYYY-MM-DD).

Technischer Anhang

Nach dem Erstellen des benutzerfreundlichen Changelogs frage:

„Möchtest du, dass ich auch einen technischen Anhang mit Implementierungsdetails erstelle? (nützlich für entwicklerorientierte Dokumentation)“

Wenn ja, erstelle einen detaillierteren Abschnitt mit technischen Einzelheiten, Breaking-Change-Migrationsanleitungen und API-Änderungen.

Schreibregeln

  • Verwende niemals Gedankenstriche im generierten Inhalt. Keine „---“-Zeichen. Verwende stattdessen Kommas, Doppelpunkte, Punkte oder Klammern.
  • Standardmäßig benutzerfreundliche Sprache (kein Jargon, keine internen Funktionsnamen)
  • Ein Eintrag pro Zeile, maximal zwei für komplexe Änderungen
  • Konsistente Verb-Zeitform (Vergangenheit: „Hinzugefügt“, „Behoben“, „Entfernt“)
  • PR/Issue-Referenzen einfügen, wo verfügbar

Phase 4: Überprüfen

Präsentiere den vollständigen Changelog-Eintrag:

„Hier ist der Changelog:“

## [1.2.0] - 2026-04-11

### Hinzugefügt
- Du kannst Berichte jetzt als PDF exportieren (#123)

### Behoben
- Dashboard flackert nicht mehr beim Laden der Seite (#456)

„Möchtest du Änderungen?“

Warte auf Freigabe. Fahre nur mit der Ausgabe fort, wenn der Benutzer bestätigt.

Phase 5: Ausgabe

CHANGELOG.md

Erkenne vorhandene CHANGELOG.md im Repository-Root. Wenn gefunden, lies die gesamte Datei, identifiziere den Einfügepunkt (vor der ersten ## [-Zeile), präsentiere dem Benutzer den vorgeschlagenen Einfügepunkt und bestätige vor dem Schreiben. Wenn nicht gefunden, erstelle eine mit einem Standard-Header:

# Changelog

Alle wichtigen Änderungen an diesem Projekt werden in dieser Datei dokumentiert.

Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/).

Bestätige immer vor dem Schreiben:

„Ich werde dies an den Anfang von CHANGELOG.md setzen. Alles klar?“

GitHub Release

Nach dem Speichern des Changelogs frage:

„Möchtest du, dass ich auch ein GitHub Release mit diesem Changelog erstelle?“

Wenn ja, verwende gh release create <Tag> --notes "<Changelog-Inhalt>", um das Release zu erstellen. Wenn gh nicht verfügbar ist, informiere den Benutzer und überspringe diesen Schritt.

Fehlerbehandlung

  • gh nicht verfügbar -> Benutzer informieren, PR-Anreicherung und GitHub Release überspringen, sich nur auf Git-Log verlassen
  • Ungültiger Ref/Tag -> Benutzer bitten, zu überprüfen
  • Keine Commits im Bereich -> Benutzer informieren, bitten, den Bereich zu überprüfen
  • Kein Produktkontext -> Benutzer bitten, das Produkt zu beschreiben
  • Nicht-konventionelle Commits -> Zurückfallen auf Diff-Analyse zur Kategorisierung

Was dieses Skill NICHT tut

  • Versionsstrategie verwalten (Entscheidungen über semantische Versionierung liegen beim Benutzer)
  • In Paketregister veröffentlichen
  • Blogbeiträge oder Newsletter generieren (verwende /blog-post oder /newsletter)
  • Branching-Strategien oder Release-Workflows handhaben

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Verwandte Skills