Skip to content

Release Changelog Writer

Drafts the stable Paperclip release changelog from commits, changesets and merged PRs.

Stars
110,078
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent how the Paperclip project writes its stable release notes. Once installed, the agent follows a fixed process: it finds the last stable release tag, identifies the beta build being promoted, gathers commit messages, changeset files and merged pull requests, flags likely breaking changes, and drafts a user-facing changelog in the required sections. It also checks for an existing changelog before overwriting anything and asks the reviewer what to do if one exists.

Great for

  • Maintainers of the Paperclip project preparing a stable release
  • Release managers who need a consistent first draft of release notes to review

Skip it if

  • People outside the Paperclip project, since it hard-codes its repository paths, tags, scripts and branch conventions
  • Anyone who expects the agent to publish a release on its own; the file only describes drafting steps and the release itself is run by maintainers, and a wrong version or range could publish misleading notes

Try asking

  • “Draft the stable changelog for the next Paperclip release from the current beta”
  • “Check whether a release notes file already exists for beta 2026.318.0 and summarise it before I decide what to change”
  • “Flag any breaking changes between the last stable tag and the beta source commit”
Step-by-step guide: how to use Release Changelog WriterInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    release-changelog.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip release-changelog.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip release-changelog.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at a specific beta version so it resolves the correct source commit rather than master.
  • Review the generated Breaking Changes section yourself, since detection relies on commit message patterns and file diffs.
  • Confirm the previous stable notes file exists so the agent can describe changes as deltas instead of repeating old features.

What's inside

  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.