gen-changelog

Generate changelog entries from git changes and sync docs.

11.1k|1.3k|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/MoonshotAI/kimi-cli --skill gen-changelog-moonshotai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gen-changelog
Source: https://github.com/MoonshotAI/kimi-cli/tree/main/.agents/skills/gen-changelog
Command: npx skills add https://github.com/MoonshotAI/kimi-cli --skill gen-changelog-moonshotai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Chasing manual updates to CHANGELOG.md across the root and per-package logs is error-prone and time-consuming. This Skill automates generating changelog entries from code changes and ensures updates are reflected across the documentation site.

Core Features & Use Cases

  • Analyze changes between the current branch and main using git logs and diffs.
  • Update the root CHANGELOG.md under the Unreleased section and propagate updates to package changelogs in packages/ and sdks/ when needed.
  • Synchronize the English docs changelog via docs/scripts/sync-changelog.mjs and mirror entries in Chinese docs (docs/zh/release-notes/changelog.md) following the project style.
  • Handle breaking changes by adding entries to both English and Chinese breaking-change docs with proper formatting.
  • Use case: release a feature that touches multiple packages; generate and publish corresponding changelog entries across the repo and docs site.

Quick Start

Analyze your current branch against main, generate the corresponding changelog entries, and synchronize them to the documentation site.

Frequently Asked Questions about gen-changelog

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

FAQPage Schema
How do I automatically generate a changelog from git commits?

You can automatically generate a changelog from git commits by analyzing code changes between your current branch and main, then updating the Unreleased section of your root CHANGELOG.md with the extracted commit logs and diffs.

How do I update changelogs for multiple packages in a monorepo?

To update monorepo package changelogs, the system propagates root CHANGELOG.md entries to individual package logs located under the packages/ and sdks/ directories, ensuring all sub-packages reflect the latest code changes.

Does this changelog generator work with bilingual documentation sites?

Yes, it synchronizes changelog entries to the English documentation site via docs/scripts/sync-changelog.mjs and mirrors the formatted entries into the Chinese docs at docs/zh/release-notes/changelog.md to maintain bilingual documentation.

What do I need to generate breaking change entries for release notes?

To generate breaking change entries, the system requires git access and the root CHANGELOG.md, automatically adding properly formatted entries to both English and Chinese breaking-change docs during the synchronization process.

Can I use this to sync changelogs across my documentation site?

Yes, you can sync changelogs across your documentation site by running the docs/scripts/sync-changelog.mjs script, which mirrors generated changelog entries from the root repository to the online documentation structure.