release-changelog

Compile user-facing changelogs for Paperclip calver stable releases.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually compiling accurate, user-facing changelogs for Paperclip's stable releases is time-consuming and error-prone, requiring cross-referencing commits, changesets, and merged pull requests while adhering to the project's calendar versioning rules and contributor attribution guidelines.

Core Features & Use Cases

  • Automated Input Aggregation: Collects commit history, changeset files, and merged PR context since the last stable tag to ensure no relevant changes are missed.
  • Structured Categorization: Organizes changes into user-facing sections (Breaking Changes, Highlights, Improvements, Fixes) and flags breaking changes with clear upgrade paths.
  • Compliant Attribution: Correctly lists contributors by GitHub username, excluding bot accounts and core maintainers per project rules.
  • Use Case: Paperclip maintainers can use this skill to quickly generate a compliant, accurate changelog for a new stable release without manually sifting through dozens of commits and PRs.

Quick Start

Use the release-changelog skill to generate the user-facing changelog for the next Paperclip stable release using recent commits, changesets, and merged pull requests.

Frequently Asked Questions about release-changelog

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

FAQPage Schema
How do I automate changelog generation for calendar-versioned stable releases?

Automating changelog generation for calver stable releases involves aggregating commit data, changeset files, and merged pull request context to compile accurate release documentation. This process automatically categorizes user-facing changes and applies compliant contributor attribution.

How does breaking change detection work when compiling release notes?

Breaking change detection works by analyzing aggregated commit history and changeset files to flag breaking changes. The generated release notes then include clear, user-facing upgrade paths alongside each detected breaking change.

Can I automatically exclude bots and core team members from contributor attribution?

Yes, you can automatically exclude bots and core team members from contributor attribution. The changelog compilation process applies compliant attribution rules, listing external contributors by GitHub username while omitting bot accounts and core maintainers.

How do I prevent overwriting existing changelog files during release automation?

You prevent overwriting existing changelog files through idempotency checks. Before generating new release documentation, the system performs idempotency checks to ensure existing changelog files remain untouched during the automation process.

Does automated release documentation support categorizing changes into highlights and fixes?

Yes, automated release documentation supports categorizing changes into structured user-facing sections. The generated changelog organizes changes into categories like Breaking Changes, Highlights, Improvements, and Fixes to align with documentation standards.

What is the best way to compile user-facing changelogs from merged pull requests and changesets?

The best way to compile user-facing changelogs is to aggregate merged pull request context and changeset files since the last stable tag. This ensures no relevant changes are missed and the output formatting aligns with release documentation standards.