Changelog Management

Generate and consolidate CHANGELOG.md entries from Git commits.

309|15|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/ShareX/XerahS --skill changelog-management-sharex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Changelog Management
Source: https://github.com/ShareX/XerahS/tree/main/.ai/skills/update-changelog
Command: npx skills add https://github.com/ShareX/XerahS --skill changelog-management-sharex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Changelog management is error-prone and time-consuming; this Skill automates generating and updating CHANGELOG.md by consolidating commits into version sections based on Git history and project versioning.

Core Features & Use Cases

  • Automates draft generation from commits since the last release tag
  • Consolidates and upserts entries into docs/CHANGELOG.md based on Directory.Build.props version
  • Supports optional FromTag inputs to control the scope of changes for a release

Quick Start

Run the PowerShell script to generate a draft changelog section and apply it to docs/CHANGELOG.md.

Frequently Asked Questions about Changelog Management

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

FAQPage Schema
How do I automate changelog generation from Git commits for a new release?

Automating changelog generation from Git commits involves consolidating commit history between tags into versioned sections. This Skill uses a PowerShell script to parse Git history and draft entries based on your project's versioning.

How do I consolidate Git commit history into a CHANGELOG.md file?

Consolidating Git commit history into CHANGELOG.md requires upserting parsed commit entries into version sections. The Skill automates this by reading the Directory.Build.props version and applying the consolidated changes directly to the file.

Can I control the scope of Git commits included in my changelog draft?

You can control the scope of Git commits in your changelog draft by providing optional FromTag inputs. This allows the PowerShell script to limit the consolidation to changes occurring after a specific release tag.

How does versioning integration work when updating changelogs?

Versioning integration for changelogs works by reading the version defined in Directory.Build.props. The Skill uses this project version to group consolidated Git commits into the correct release section within docs/CHANGELOG.md.

Do I need PowerShell to automate drafting release notes from Git history?

You need PowerShell to automate drafting release notes from Git history because the Skill executes the supplied update-changelog.ps1 script. This script handles the logic of querying Git and consolidating the entries.

What is the best way to manage changelog entries for versioned releases without manual errors?

The best way to manage changelog entries for versioned releases without manual errors is automating the consolidation of Git commits. This Skill upserts generated draft sections into your docs/CHANGELOG.md file based on Git tags and project versioning.