releasenote

Create or update Reno release note YAML fragments for current branch changes.

648|537|Updated Jun 20, 2016
One-click install
npx skills add https://github.com/DataDog/dd-trace-py --skill releasenote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: releasenote
Source: https://github.com/DataDog/dd-trace-py/tree/main/.claude/skills/releasenote
Command: npx skills add https://github.com/DataDog/dd-trace-py --skill releasenote

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and updating of release notes for changes on the current branch, following dd-trace-py's conventions and Reno workflow.

Core Features & Use Cases

  • Reno-based fragments: Generate per-change fragments under releasenotes/notes/.
  • Guided categorization: Prompt-based confirmation of feature, bugfix, deprecation, or breaking-change categories.
  • Consistent formatting: Ensures user-facing wording and structure for release notes.

Quick Start

Start a new release note skeleton with: riot run reno new <title-slug> After generation, edit the YAML fragment under releasenotes/notes/ to describe the change.

Frequently Asked Questions about releasenote

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

FAQPage Schema
How do I automate release note creation for my project?

Automate release note creation by using Reno to generate per-change YAML fragments in your releasenotes/notes/ directory. Run `riot run reno new <title-slug>` to start a new fragment, confirm the category (feature, bugfix, deprecation, or breaking-change), and the Skill outputs a formatted YAML file following your project's release-note conventions.

What is Reno and how does it organize release notes?

Reno is a release-note management tool that organizes changes as individual YAML fragment files stored in a dedicated notes directory. Each fragment describes a single change with category and description, and Reno combines them into a consolidated release note, eliminating merge conflicts and enforcing consistent formatting across contributors.

Can I use this Skill to update existing release notes?

Yes, this Skill creates or updates release notes for changes on your current branch. After the Skill generates a YAML fragment under releasenotes/notes/, you can edit it to refine the description, category, and wording before it merges into your final release notes.

What format does the Skill output for release notes?

The Skill outputs YAML fragments with a .yaml suffix stored under releasenotes/notes/. Each fragment contains the change category, slug identifier, and user-facing description, conforming to Reno's structure and your project's docs/releasenotes.rst conventions.

Do I need to manually categorize changes, or does the Skill handle it?

The Skill uses guided prompts to confirm the change category—feature, bugfix, deprecation, or breaking-change—before generating the fragment. You validate the category during the workflow; the Skill enforces consistency with your project's Reno-based release-note process.

What prerequisites do I need before creating a release note with this Skill?

You need Reno installed, riot configured for your project, and changes committed to your current branch. The Skill expects your project to follow dd-trace-py conventions with a docs/releasenotes.rst file and a releasenotes/notes/ directory already established.