release-notes

Draft GitHub release notes with curated sections and strict structure.

5|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/CertaMesh/gaze --skill release-notes-certamesh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-notes
Source: https://github.com/CertaMesh/gaze/tree/main/.claude/skills/release-notes
Command: npx skills add https://github.com/CertaMesh/gaze --skill release-notes-certamesh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft GitHub release notes with a curated narrative and strict structure, so teams communicate changes clearly and maintain a consistent voice across releases.

Core Features & Use Cases

  • Focused on producing release notes with Opening paragraph, TL;DR, Highlights, Known limitations, Adopter notes, Download, and Full CHANGELOG sections.
  • Enforces use of the curated narrative voice and alignment with the Keep-a-Changelog format on top of the changelog.
  • Guides release authors through gating and QA checks to ensure the release communicates scope and impact accurately.

Quick Start

Draft the release body for vX.Y.Z following the curated structure and narrative voice.

Frequently Asked Questions about release-notes

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

FAQPage Schema
How do I draft GitHub release notes with a consistent narrative voice?

To draft GitHub release notes with a consistent narrative voice, use a structured template that enforces exact section ordering, required terminology, and inline PR anchor references. This ensures every software release maintains a curated, unified communication style across repositories.

What sections should be included in a structured software change log?

A structured software change log should include an Opening paragraph, TL;DR, Highlights, Known limitations, Adopter notes, Download, and Full CHANGELOG sections. Enforcing this exact section ordering ensures adopters clearly understand release scope and impact.

How do I generate release notes that align with the Keep-a-Changelog format?

To generate release notes aligned with the Keep-a-Changelog format, follow a strict template that maps curated narrative sections to versioned links. This maintains structural consistency while guiding authors through gating and QA checks for accurate impact communication.

Can I enforce required terminology and PR anchor references in GitHub release notes?

Yes, you can enforce required terminology and PR anchor references in GitHub release notes by using a strict drafting structure. This guarantees that inline references and specific vocabulary remain consistent across all software releases.

What is the best way to communicate known limitations to software adopters?

The best way to communicate known limitations to software adopters is to include a dedicated Known limitations and Adopter notes section within your release notes. This structured approach accurately conveys release scope and impact alongside the main highlights.

Why does my release notes formatting break across different repositories?

Release notes formatting breaks across repositories when lacking a strict structure enforcing exact section ordering and required terminology. Applying a standardized template with a curated narrative voice ensures consistent formatting and reliable versioned CHANGELOG links.