Skip to content

Paperclip Release Coordinator

Runs Paperclip's full maintainer release workflow: canary checks, stable publish, smoke tests, and follow-up tasks.

Stars
110,078
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent the step-by-step process Paperclip's maintainers use to ship a release, rather than just running an npm publish. The agent checks preconditions, verifies the candidate commit with typecheck, tests and build, validates the automatic canary, runs a Docker smoke test, guides a manual stable promotion through a GitHub workflow, and creates follow-up tasks for the changelog, website, and announcements. It also creates a linked set of release-content case records in Paperclip when that feature is enabled.

Great for

  • Paperclip maintainers who need to cut or verify a stable release
  • Release managers who want a consistent checklist for canary-to-stable promotion

Skip it if

  • Anyone outside the Paperclip maintainer team, since it depends on the repo's specific scripts, workflows and npm package names
  • Casual discussion of versioning: the skill is meant to run only when a real release is requested, and publishing to npm or GitHub is hard to undo

Try asking

  • “Do a release: verify the latest canary and prepare a stable promotion from a chosen commit”
  • “Run the Docker smoke test against the current canary and report the result”
  • “Draft the stable changelog for the next release and create the follow-up website and announcement tasks”
  • “Promote this canary to stable as a dry run first”
Step-by-step guide: how to use Paperclip Release CoordinatorInstall, 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.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip release.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

  • Always run the stable workflow in dry-run mode before a live publish, as the skill recommends.
  • Make sure a human reviews the generated changelog before anything is published.
  • Start with the canary check and smoke test; stop and fix on master if smoke testing fails.

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.