release-notes

Generate release notes from per-PR analysis of merged pull requests since the last release.

4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill release-notes-fbakkensen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-notes
Source: https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace/tree/main/plugins/release-notes/skills/release-notes
Command: npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill release-notes-fbakkensen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing release notes for an AL/Business Central app means manually reviewing every merged PR since the last release, classifying changes, and drafting consistent markdown — a slow, error-prone process that often produces vague entries like "Updated logic". ## Core Features & Use Cases - Automated PR Analysis: The PowerShell script Get-ReleaseAnalysis.ps1 extracts all merged PRs between releases via git log and GitHub CLI, producing a structured JSONL file with summaries, file categories, and breaking-change indicators. - Per-PR Classification: Each PR is classified as feature, improvement, bugfix, breaking, technical, or excluded using a defined protocol, with a Deep Dive fallback for vague entries. - Structured Markdown Output: Renders canonical release notes with emoji-marked sections (New Features, Improvements, Bug Fixes, Breaking Changes, Technical Summary) written to .output/releases/RELEASE-NOTES-<VERSION>.md. - Use Case: After merging a dozen PRs for version 27.7.0 of a Business Central app, run the skill to produce complete, self-contained release notes with named pages, actions, and migration steps — no PR links required. ## Quick Start Ask the agent to generate release notes for the current version of the app, and it will run the analysis script, classify each merged PR, and write the final markdown file.

Frequently Asked Questions about release-notes

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

FAQPage Schema
How do I generate release notes from merged pull requests?

Run the Get-ReleaseAnalysis.ps1 script to produce a JSONL file of all PRs merged since the last release, then the skill classifies each PR and renders markdown release notes to .output/releases/RELEASE-NOTES-<VERSION>.md.

How are pull requests classified for release notes?

Each PR is classified by ordered rules: breaking changes first, then excluded test/docs/CI changes, then feature, bugfix, technical, or improvement based on commit prefixes and user-facing impact. Vague entries trigger a Deep Dive Protocol that re-reads the PR body and AL changes.

What tools does the release analysis script require?

The PowerShell script requires git and the GitHub CLI (gh) with repository access. It uses gh release list, gh pr view, and git log to identify merged PRs and their diffs between release tags.

Can I generate release notes between two specific release tags?

Yes. Pass -Tag and -PreviousTag parameters to Get-ReleaseAnalysis.ps1 to analyze changes between two releases, for example -Tag "27.7.0" -PreviousTag "27.6.0", instead of comparing the latest release to HEAD.

What are the limitations of this release notes workflow?

It handles one version per run, writes only to the fixed .output/releases path, and excludes PR or issue links from output. It does not re-run analysis mid-flow; vague PR records are fixed via the Deep Dive Protocol instead.