release-changelog

Generate stable Paperclip release changelogs by aggregating commits, changesets, and merged PRs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/windingriverholdings/paperclip --skill release-changelog-windingriverholdings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-changelog
Source: https://github.com/windingriverholdings/paperclip/tree/main/.agents/skills/release-changelog
Command: npx skills add https://github.com/windingriverholdings/paperclip --skill release-changelog-windingriverholdings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of user-facing release notes for Paperclip's stable releases by aggregating commits, changesets, and merged PR context since the last stable tag.

Core Features & Use Cases

  • Aggregates commits, changesets, and merged PR context to build a complete changelog.
  • Outputs the file at releases/vYYYY.MDD.P.md following the calver convention and can exclude canary releases.
  • Supports categorization into sections such as Breaking Changes, Highlights, Improvements, and Fixes with upgrade guidance when necessary.

Quick Start

Generate the stable Paperclip changelog at releases/vYYYY.MDD.P.md by aggregating commits, changesets, and merged PRs since the last stable tag.

Frequently Asked Questions about release-changelog

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

FAQPage Schema
How do I automate release changelog generation from merged PRs and commits?

This Skill aggregates commits, changesets, and merged PR context since the last stable tag to build a complete release changelog. It automatically categorizes updates into sections like Highlights, Improvements, and Fixes.

How does calver versioning apply to release notes files?

Calver versioning applies to release notes by outputting the changelog file at releases/vYYYY.MDD.P.md. This convention ensures stable releases are chronologically organized, while canary tags are explicitly excluded from generating changelogs.

How do I document breaking changes and upgrade guidance in a changelog?

You document breaking changes and upgrade guidance by enforcing a defined section structure within the aggregated changelog. When breaking changes are detected from PRs or changesets, the output includes dedicated upgrade instructions for users.

Can I exclude canary releases from the automated changelog output?

Yes, you can exclude canary releases from the automated changelog output. The generation workflow is designed specifically for stable releases and inherently skips canary tags to prevent unstable changes from appearing in user-facing notes.

Does the changelog generation process support idempotency for repeated runs?

Yes, the changelog generation process enforces idempotency for repeated runs. This ensures that executing the aggregation workflow multiple times against the same stable tag produces identical changelog output without duplicating entries.