bmad-os-changelog

Generate structured changelog entries from git history and pull request metadata.

8|2|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/bmad-code-org/bmad-utility-skills --skill bmad-os-changelog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-os-changelog
Source: https://github.com/bmad-code-org/bmad-utility-skills/tree/main/skills/bmad-os-changelog
Command: npx skills add https://github.com/bmad-code-org/bmad-utility-skills --skill bmad-os-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates the manual effort and inconsistency involved in drafting release notes by automatically analyzing git history and PR context to generate accurate, well-formatted changelog entries.

Core Features & Use Cases

  • Context-Aware Drafting: Analyzes merged PRs and issues to provide meaningful summaries rather than just raw commit messages.
  • Standardized Formatting: Automatically categorizes changes into Features, Breaking Changes, and Other, ensuring a professional project history.
  • Quality Assurance: Integrates a mandatory writing-quality pass to strip AI-generated filler and ensure clear, concise communication.

Quick Start

Run the bmad-os-changelog skill to analyze changes since the last release and draft the new version entry directly into your project CHANGELOG.md file.

Frequently Asked Questions about bmad-os-changelog

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

FAQPage Schema
How do I generate a changelog from git commit history?

Generating a changelog from git commit history involves analyzing merged pull requests and commit context to categorize changes into Features and Breaking Changes. This process automatically drafts structured release notes directly into your CHANGELOG.md.

Can I automatically categorize pull requests into release notes?

Yes, automatically categorizing pull requests into release notes groups changes into standardized sections like Features, Breaking Changes, and Other. It analyzes PR metadata to provide meaningful summaries rather than raw commit messages.

Does generating changelog entries require a specific project setup?

Generating changelog entries requires access to your local git history and the project's CHANGELOG.md file. The skill performs non-destructive updates directly into this existing documentation.

What is the best way to format AI-generated release notes?

The best way to format AI-generated release notes is applying a mandatory writing-quality pass to strip filler content. This ensures clear, concise communication while maintaining professional project history standards.

Why do my automated changelogs contain so much filler text?

Automated changelogs contain filler text when lacking a strict writing-quality pass. Applying quality assurance standards during generation strips AI-generated filler to ensure clear, concise communication in your project documentation.

Are there limitations to non-destructive changelog updates?

Limitations of non-destructive changelog updates include relying entirely on existing local git history and PR metadata accuracy. It updates the CHANGELOG.md file without overwriting previous entries but cannot invent missing context.