changelog-generator

Analyze git commit history to generate markdown changelogs grouped by category.

Updated Dec 13, 2024
One-click install
npx skills add https://github.com/neo-picasso-2112/dotfiles --skill changelog-generator-neo-picasso-2112
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-generator
Source: https://github.com/neo-picasso-2112/dotfiles/tree/main/.claude/skills/changelog-generator
Command: npx skills add https://github.com/neo-picasso-2112/dotfiles --skill changelog-generator-neo-picasso-2112

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts technical git commits into polished, customer-friendly release notes that help communicate changes to users and stakeholders.

Core Features & Use Cases

  • Scans Git History: Analyzes commits from a specific time period or between versions
  • Categorizes Changes: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
  • Translates Technical → User-Friendly: Converts developer commits into customer language
  • Formats Professionally: Creates clean, structured changelog entries
  • Filters Noise: Excludes internal commits (refactoring, tests, etc.)
  • Follows Best Practices: Applies changelog guidelines and your brand voice

Quick Start

Run the tool in your git repository to generate a changelog from the commits since your last release.

Frequently Asked Questions about changelog-generator

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

FAQPage Schema
How do I generate customer-friendly release notes from git commits?

Generating customer-friendly release notes from git commits involves scanning your commit history, filtering out internal noise like refactoring, and grouping changes into clear markdown sections for features, improvements, and fixes.

What is the best way to automatically categorize git commits for a changelog?

Automatically categorizing git commits for a changelog involves grouping them into logical categories like features, bug fixes, and security updates, while translating technical jargon into customer-facing language.

Can I exclude internal commits like tests and refactoring from my changelog?

Yes, you can exclude internal commits from your changelog by filtering out noise such as refactoring and tests, ensuring only customer-facing changes appear in the final markdown release notes.

Does the changelog generator work without external dependencies?

Yes, the changelog generator works without external dependencies, requiring only your git repository history to analyze commits and output structured markdown release notes.

How do I format markdown release notes for software versioning?

Formatting markdown release notes for versioning involves grouping commits by category and outputting well-formatted markdown with distinct sections for features, improvements, and fixes following changelog best practices.

When do I need to generate a changelog from git history?

You need to generate a changelog from git history when preparing release notes, weekly summaries, or customer communications to clearly communicate software changes to stakeholders.