release-changelog

Generate Paperclip release changelogs from git commits, changesets, and merged PRs.

76.0k|14.2k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/paperclipai/paperclip --skill release-changelog-paperclipai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-changelog
Source: https://github.com/paperclipai/paperclip/tree/main/.agents/skills/release-changelog
Command: npx skills add https://github.com/paperclipai/paperclip --skill release-changelog-paperclipai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of user-facing changelogs for stable software releases, ensuring consistency and saving developers significant manual effort.

Core Features & Use Cases

  • Automated Changelog Generation: Reads commits, changesets, and PR data to compile a changelog.
  • Breaking Change Detection: Identifies and flags critical changes that require user attention.
  • Categorization: Organizes changes into user-friendly sections like 'Breaking Changes', 'Improvements', and 'Fixes'.
  • Contributor Attribution: Automatically includes and formats contributor information.
  • Use Case: Before releasing a new version of Paperclip, this Skill can be invoked to draft the releases/vX.Y.Z.md file, ensuring all significant changes are documented accurately and efficiently.

Quick Start

Use the release-changelog skill to generate the changelog for the next stable release.

Frequently Asked Questions about release-changelog

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

FAQPage Schema
How do I generate a changelog from git commits automatically?

You can generate a changelog from git commits automatically by invoking this Skill to read your commit history, changesets, and merged PRs since the last stable tag. It then categorizes updates and flags breaking changes for user clarity.

How do I detect breaking changes for release notes from merged PRs?

Detecting breaking changes for release notes is handled by analyzing merged PRs and commit data. The Skill identifies critical updates that require user attention and categorizes them into a dedicated 'Breaking Changes' section in the final changelog.

What is the best way to categorize updates in a software changelog?

The best way to categorize updates in a software changelog is to analyze commit data and organize changes into predefined, user-friendly sections. This Skill automatically sorts updates into 'Breaking Changes', 'Improvements', and 'Fixes' for maximum user clarity.

Can I include contributor attribution when generating release notes from git?

Yes, you can include contributor attribution when generating release notes. This Skill automatically extracts contributor information from merged PRs and formats it inline within the generated changelog document.

Do I need changesets to create an automated changelog for a stable release?

You do not strictly need changesets to create an automated changelog, as the Skill can analyze git commits and merged PRs independently. However, incorporating changesets alongside commit data provides a more comprehensive and accurate release log.

What are the limitations of using git commits for changelog generation?

A limitation of using git commits for changelog generation is that the output relies entirely on commit message and PR data quality. If commit messages lack clear context or breaking change indicators, the automated categorization may miss critical updates.