release-changelog

Generate a stable release changelog from commits and changesets.

71|33|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/IncomeStreamSurfer/paperclip-surfers --skill release-changelog-incomestreamsurfer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-changelog
Source: https://github.com/IncomeStreamSurfer/paperclip-surfers/tree/main/.agents/skills/release-changelog
Command: npx skills add https://github.com/IncomeStreamSurfer/paperclip-surfers --skill release-changelog-incomestreamsurfer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, git, gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of release changelogs for Paperclip, reducing the manual effort required to compile and organize release notes.

Core Features & Use Cases

  • Automated Changelog Generation: Generates a stable release changelog by analyzing commits and changesets since the last stable tag.
  • Calendar Versioning: Follows the calendar versioning model to determine the version for the changelog.
  • Breaking Changes Detection: Identifies and flags breaking changes with upgrade paths.
  • User-Friendly Structure: Organizes changelogs into user-friendly sections: Breaking Changes, Highlights, Improvements, Fixes, and Upgrade Guide.

Quick Start

Run 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 automatically generate a release changelog from git commits?

Automated changelog generation analyzes git commits and changesets since the last stable tag to compile structured release notes. This process identifies breaking changes and organizes updates into user-friendly Markdown sections like Highlights, Improvements, and Fixes.

How are breaking changes detected and documented during changelog generation?

Breaking changes detection identifies incompatible updates within commit history and flags them in the changelog. It automatically generates an Upgrade Guide section within the Markdown output, providing users with clear migration paths for the new stable release.

Do I need Python and git installed to generate Markdown changelogs?

Yes, you need Python, git, and gh installed to process commit history and generate changelogs. Python handles the commit analysis and Markdown formatting, while git and gh provide access to repository history and release tags.

How does calendar versioning affect automated changelog generation?

Calendar versioning determines the release version number assigned to the generated changelog. The automated process reads the date-based versioning scheme from repository tags to accurately title and organize the Markdown release notes for the stable release.

What is the best way to structure release notes for a stable version?

Structuring release notes involves organizing commit analysis into distinct Markdown sections: Breaking Changes, Highlights, Improvements, Fixes, and an Upgrade Guide. This user-friendly structure ensures readers can quickly understand the impact of the new stable release.

Can I generate changelogs for changesets since an arbitrary git tag?

Changelog generation specifically analyzes commits and changesets since the last stable tag. Processing focuses on capturing the delta between the previous stable release and the upcoming version to ensure accurate release notes.