skills.rest
grafana
grafanaOFFICIAL
Explore all skills by this author →
Website𝕏@grafanaGitHub

changelog

Draft a CHANGELOG.md entry from merged PRs since the last release tag.

19|31|Updated May 29, 2025
Search Tags:#automation#changelog#release management#pull requests#grafana#pr workflow
One-click install
npx skills add https://github.com/grafana/grafana-pathfinder-app --skill changelog-grafana
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: changelog
Source: https://github.com/grafana/grafana-pathfinder-app/tree/main/.cursor/skills/changelog
Command: npx skills add https://github.com/grafana/grafana-pathfinder-app --skill changelog-grafana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft a CHANGELOG.md entry from merged PRs since the last release tag. Categorizes by conventional-commit prefix (Added / Fixed / Chore / Security / Changed), rewrites PR titles into sentence-case narrative bullets with PR refs, and commits to the current branch without pushing. Use when preparing a release, or call this skill from /release-prep.

Core Features & Use Cases

  • Drafts CHANGELOG.md entries by aggregating merged PRs since the last tag.
  • Rewrites PR titles into sentence-case narrative bullets with PR refs for clear release notes.
  • Categorizes entries into Added, Fixed, Chore, Security, Changed, and enforces Grafana-style capitalization rules.

Quick Start

Run the changelog skill in the repository to generate the next CHANGELOG.md draft for review and release preparation.

Frequently Asked Questions about changelog

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

FAQPage Schema
How do I generate CHANGELOG.md entries from merged pull requests?▼

You can generate CHANGELOG.md entries by aggregating merged PRs since the last release tag using gh pr list. The tool categorizes entries by conventional-commit prefix and rewrites PR titles into sentence-case narrative bullets with PR references.

How does automatic changelog categorization work for release notes?▼

Automatic changelog categorization works by parsing conventional-commit prefixes from merged PR titles. Entries are sorted into Added, Fixed, Chore, Security, and Changed categories, with Grafana-style capitalization rules applied to format the narrative bullets.

What is the best way to automate release preparation workflows for Grafana?▼

Automating release preparation involves drafting version notes from merged PRs and categorizing them per Grafana style. You can invoke this process directly from a release-prep workflow to generate and locally commit the next CHANGELOG.md draft for review.

Does the changelog drafting process commit and push changes to the remote repository?▼

The changelog drafting process commits the generated CHANGELOG.md file locally to the current branch without pushing. This ensures release notes remain local for review before any remote repository updates occur.

Can I use this changelog generation tool with repositories that do not follow conventional commits?▼

This tool expects conventional-commit prefixes to categorize entries into Added, Fixed, Chore, Security, and Changed. Repositories lacking these prefixes may not be categorized correctly, resulting in unsorted or misclassified changelog entries.

Related Skills

Explore More Software Engineering Skills→
YanCheng-goYanCheng-go
3

release

Generate a changelog, bump the version, and open a release PR.

Community
Intermediate
chuangkevinchuangkevin

finishing-a-development-branch

Verify tests and merge, push, create a PR, keep, or discard a git feature branch.

Community
Intermediate
zhaow-dezhaow-de

release

Automate GitHub repository releases with version bumping, PR creation, and tag pushing.

Community
Advanced
plurigridplurigrid
60

changelog-generator

Generate user-facing changelogs from git commit history.

Official
Advanced