changelog-writer

Generate changelogs, release notes, and migration guides from git history.

4|1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/wyattowalsh/agents --skill changelog-writer-wyattowalsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-writer
Source: https://github.com/wyattowalsh/agents/tree/main/skills/changelog-writer
Command: npx skills add https://github.com/wyattowalsh/agents --skill changelog-writer-wyattowalsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) and data (resource) components.

What problem does it solve?

This Skill automates the generation of changelogs, release notes, and migration guides directly from your git history, saving significant time and ensuring consistency.

Core Features & Use Cases

  • Automated Changelog Generation: Creates Keep a Changelog formatted output from conventional commits.
  • Release Notes Drafting: Generates user-facing release notes summarizing key changes.
  • Breaking Change Detection: Identifies and summarizes backward-incompatible changes.
  • Migration Guide Creation: Assists in generating step-by-step instructions for users to migrate between versions.
  • Version Bump Recommendation: Suggests semantic version bumps (major, minor, patch) based on commit analysis.
  • Use Case: After merging a new feature and several bug fixes, use this Skill to generate the changelog entry for the upcoming release, ensuring all changes are documented accurately.

Quick Start

Use the changelog writer skill to generate the changelog for the latest release.

Frequently Asked Questions about changelog-writer

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

FAQPage Schema
How do I generate a changelog from conventional commits in git history?

To generate a changelog from conventional commits, this Skill analyzes your git history and automates classification, formatting, breaking change detection, and version bump recommendations. It outputs Keep a Changelog formatted entries directly from your commit messages.

Can I automatically detect breaking changes and suggest semantic version bumps?

Yes, you can automatically detect breaking changes and suggest semantic version bumps. This Skill analyzes commit history to identify backward-incompatible changes and recommends major, minor, or patch version bumps based on conventional commit types.

What is the best way to draft release notes and migration guides from git history?

The best way to draft release notes and migration guides from git history is using this Skill to summarize key changes and generate step-by-step instructions. It automates user-facing release notes drafting directly from conventional commits.

Does this changelog generator require a specific commit format?

Yes, this changelog generator requires conventional commits format to parse git history accurately. It relies on structured commit messages to classify changes, detect breaking changes, and format Keep a Changelog output correctly.

How do I create migration guides for users to transition between software versions?

To create migration guides, this Skill processes git history to identify breaking changes and generates step-by-step instructions. It assists in drafting user-facing migration guides ensuring smooth transitions between software versions.

Are there limitations when using command-line scripts for release note generation?

Release note generation operates via command-line scripts for commit classification and changelog formatting. Limitations include dependency on conventional commit formats and requiring git history access to automate Keep a Changelog output and version bump recommendations.