changelog-generator

Generate markdown or JSON changelog entries from Conventional Commit histories.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill changelog-generator-veloxia-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-generator
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/skills/changelog-generator
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill changelog-generator-veloxia-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill turns conventional commit histories into clean, auditable release notes, removing the manual effort of drafting changelogs and checking commit formats before a release.

Core Features & Use Cases

  • Release Note Generation: Converts git ranges, refs, stdin, or input files into markdown or JSON changelog entries.
  • Commit Linting: Validates commit subjects against Conventional Commits rules and can fail CI on invalid messages.
  • Semver Guidance: Detects major, minor, or patch bumps and organizes entries into Keep a Changelog sections.
  • Use Case: A release manager can generate a tagged release draft, review breaking changes, and prepend the result into CHANGELOG.md without rewriting history.

Quick Start

Use the changelog-generator skill to generate a markdown release entry from the commits between two tags and write it into CHANGELOG.md.

Frequently Asked Questions about changelog-generator

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

FAQPage Schema
How do I generate release notes from conventional commits between two git tags?

To generate release notes from conventional commits, you can parse git tag ranges, ref ranges, stdin, or input files to produce markdown or JSON changelog entries organized into Keep a Changelog sections.

Can I validate commit messages against conventional commits rules in CI?

Yes, you can validate commit subjects against Conventional Commits rules to enforce commit-message linting, allowing your CI pipeline to fail automatically when invalid messages are detected.

How does semantic versioning bump detection work with conventional commit histories?

Semantic versioning bump detection analyzes conventional commit histories to identify major, minor, or patch changes, automatically categorizing release entries into Keep a Changelog ordered sections.

What is the best way to prepend a new changelog entry to an existing CHANGELOG.md file?

The best way to prepend a changelog entry to CHANGELOG.md is by using safe prepend-to-file behavior, which inserts the newly generated markdown release draft without rewriting existing file history.

Does changelog generation support monorepo release workflows and pull request validation?

Yes, changelog generation supports monorepo releases and pull request validation by accepting diverse inputs like git ranges, refs, stdin, and file-based inputs for CI checks.

Can I output changelog entries in JSON format instead of markdown?

Yes, you can output changelog entries in either JSON or markdown format, enabling automated processing of release notes or direct human-readable documentation drafting.