docs-changelog

Generates and formats release changelog files from version and raw release notes.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/bkrsna/gemini-cli --skill docs-changelog-bkrsna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-changelog
Source: https://github.com/bkrsna/gemini-cli/tree/main/.gemini/skills/docs-changelog
Command: npx skills add https://github.com/bkrsna/gemini-cli --skill docs-changelog-bkrsna

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Maintaining consistent changelog files across stable and preview release channels is error-prone and repetitive. This Skill standardizes how latest.md, preview.md, and index.md are updated from raw release data, eliminating manual formatting mistakes. ## Core Features & Use Cases - Version-aware routing: Automatically detects nightly, minor, and patch versions and applies the correct update procedure for stable or preview channels. - Highlights generation: Produces 3-5 bold-titled highlight points from raw release notes, prioritizing new features and excluding PR numbers and author names. - Template-based file updates: Populates provided templates to fully replace or incrementally update changelog files, including Full Changelog link rewriting. - Use Case: After cutting release v0.29.0-preview.2, provide the version, timestamp, and raw GitHub release notes, and the Skill updates docs/changelogs/preview.md with formatted highlights and a corrected compare link. ## Quick Start Update the changelog files for release v0.28.1 using the raw release notes I provide.

Frequently Asked Questions about docs-changelog

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

FAQPage Schema
How do I update changelog files for a new release automatically?

Provide the release version, timestamp, and raw release notes. The Skill analyzes the version to pick the correct procedure, generates highlights, and updates latest.md, preview.md, or index.md using the bundled templates.

How are stable and preview release changelogs handled differently?

Stable minor releases update both index.md announcements and latest.md, while preview minor releases only replace preview.md. Patch releases prepend new What's Changed entries and update the Full Changelog URL in the existing file.

What happens when the version is a nightly release?

Nightly versions are explicitly excluded. If the version string contains "nightly", the procedure stops immediately and no changelog files are modified.

Can I include PR numbers and authors in release highlights?

Highlights in latest.md and preview.md must not include PR numbers, links, or author names. Only the index.md announcement includes PR links and authors, limited to one or two entries.

Why does changelog formatting fail after updating files?

Formatting fails when npm dependencies are missing. Run npm install first, then npm run format to ensure the changelog files match the project's formatting rules.