draft-release-notes

Generate release notes and changelog entries from merged pull requests.

47.5k|2.5k|Updated Jun 20, 2019
One-click install
npx skills add https://github.com/prisma/prisma --skill draft-release-notes-prisma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draft-release-notes
Source: https://github.com/prisma/prisma/tree/main/skills-contrib/draft-release-notes
Command: npx skills add https://github.com/prisma/prisma --skill draft-release-notes-prisma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the manual, error-prone process of aggregating merged pull requests, resolving internal ticket context, and formatting release documentation for stable software releases.

Core Features & Use Cases

  • Automated PR Enumeration: Identifies all merged changes since the last stable release tag while filtering out development and beta noise.
  • Contextual Summarization: Transforms opaque internal PR titles into clear, user-facing release notes by leveraging Linear issue context without verbatim copying.
  • Standardized Formatting: Automatically generates categorized release notes and updates the project changelog, ensuring breaking changes and migration recipes are correctly highlighted.

Quick Start

Invoke the draft-release-notes skill while in the release branch to generate the release notes file and update the changelog for the upcoming stable version.

Frequently Asked Questions about draft-release-notes

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

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

You can automate release notes generation by analyzing merged pull requests and internal issue context to produce professional, user-facing changelog entries. This process requires GitHub CLI integration and access to repository commit history to verify and link all user-observable changes.

What is the best way to summarize internal PR titles into user-facing changelogs?

The best way to summarize internal PR titles is by leveraging Linear issue context to transform opaque development details into clear, user-facing release notes without verbatim copying. This ensures consistent documentation of features, fixes, and breaking changes.

How does automated changelog formatting handle breaking changes?

Automated changelog formatting handles breaking changes by applying standardized categorization that correctly highlights breaking changes and migration recipes. It automatically generates categorized release notes and updates the project changelog for the upcoming stable version.

Do I need GitHub CLI integration to generate stable release notes?

Yes, you need GitHub CLI integration and access to repository commit history to generate stable release notes. These prerequisites allow the system to verify and link all user-observable changes while filtering out development and beta noise from the final documentation.

Can I filter out beta and development noise when cutting stable release notes?

Yes, you can filter out beta and development noise when cutting stable release notes. The automated PR enumeration identifies all merged changes since the last stable release tag while excluding this noise to ensure only user-observable changes are documented.

When should I invoke the draft-release-notes skill in my workflow?

You should invoke the draft-release-notes skill while in the release branch to generate the release notes file and update the changelog for the upcoming stable version. This applies to the stable release-cutting workflow to ensure consistent documentation.