Release Notes

Generate structured release notes, changelog entries, and known issues from tasks and PR summaries.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/beekeeper-lab/foundry --skill release-notes-beekeeper-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Release Notes
Source: https://github.com/beekeeper-lab/foundry/tree/main/ai-team-library/claude/skills/release-notes
Command: npx skills add https://github.com/beekeeper-lab/foundry --skill release-notes-beekeeper-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Collects completed work items, merged changes, and resolved issues from a release cycle and produces structured release notes, a changelog entry, and a known issues list. The skill synthesizes task completion records, PR summaries, and the generation manifest to present a clear, stakeholder-friendly view of changes across features, fixes, and improvements.

Core Features & Use Cases

  • Generate release notes that summarize features, fixes, and improvements from tasks and PRs for a given version.
  • Produce a Keep a Changelog–compliant changelog entry and a known issues section for external and internal audiences.
  • Tailor output for different audiences (internal, external, or both) and integrate with existing changelog and docs workflows.

Quick Start

Provide release notes, a changelog entry, and a known-issues list for the specified version using the provided tasks, PR summaries, and manifest.

Frequently Asked Questions about Release Notes

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

FAQPage Schema
How do I automatically generate release notes from completed tasks and PR summaries?

You can generate release notes automatically by providing completed task records, PR summaries, and a release manifest. The skill parses these inputs to produce structured documentation covering features, fixes, and improvements for a specified version.

Does this release notes generator output a Keep a Changelog compliant entry?

Yes, the release notes generator produces a Keep a Changelog–compliant changelog entry alongside the main release notes and a known issues list, ensuring your documentation follows standard formatting conventions for version tracking.

Can I tailor release notes for different audiences like internal stakeholders and external users?

Yes, you can tailor release notes for different audiences by specifying internal, external, or both in the audience input. This ensures the generated documentation meets the specific informational needs of each stakeholder group.

How do I handle missing git history data when creating a changelog entry?

The changelog generation process gracefully handles missing git history data by validating available inputs like the version and changelog paths, synthesizing release notes from existing task completion records and PR summaries instead.

What is the best way to structure known issues in software release documentation?

The best way to structure known issues is to separate them into a dedicated list within your release documentation. This skill automatically parses resolved and unresolved issues from your release cycle to generate a distinct known issues section.

Do I need a release manifest to generate stakeholder-friendly release notes?

You need a release manifest along with tasks and PR summaries to generate stakeholder-friendly release notes. The process validates the version and changelog paths from these inputs to accurately categorize features, fixes, and improvements.