ship

Bump project versions, finalize CHANGELOGs, and create GitHub releases.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/rodacato/kwik-e-dev --skill ship-rodacato
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/rodacato/kwik-e-dev/tree/main/plugins/lifecycle/skills/ship
Command: npx skills add https://github.com/rodacato/kwik-e-dev --skill ship-rodacato

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the release process by bumping versions, finalizing the CHANGELOG, tagging the release, pushing changes, and creating a GitHub release. It reads docs/guides/releasing.md if present and follows it; otherwise it falls back to Keep-a-Changelog + SemVer defaults. It is not meant for setting up the release process itself — that is handled by launchpad:releasing.

Core Features & Use Cases

  • Version bumping and CHANGELOG finalization as part of a reproducible release workflow.
  • Tagging, pushing, and GitHub release creation to publish the release artifacts.
  • Follow project-specific releasing guides when available; otherwise apply standard release conventions.

Quick Start

Initiate a release by instructing the agent to cut a new release (e.g., "ship 0.1.2" or "release this"), triggering version bumps, changelog finalization, tagging, and GitHub release creation.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate GitHub releases and CHANGELOG finalization?

Automate GitHub releases by bumping project versions, finalizing the CHANGELOG Unreleased section, tagging commits, and creating the GitHub release. The workflow reads a custom release guide if present or defaults to Keep-a-Changelog and SemVer conventions.

What is the best way to bump SemVer versions and tag reproducible releases?

Bump SemVer versions reproducibly by applying deterministic release steps that check the current version, finalize changelog entries, tag the commit, and push changes to GitHub. It follows standard Keep-a-Changelog conventions unless a custom releasing guide overrides the defaults.

Can I use a custom releasing guide instead of Keep-a-Changelog defaults?

Yes, you can use a custom releasing guide. The automation reads docs/guides/releasing.md if present and follows its instructions for versioning and tagging, defaulting to Keep-a-Changelog and SemVer standards only when no guide is available.

Do I need an Unreleased section in my CHANGELOG to cut a new release?

Yes, an Unreleased section in the CHANGELOG is required. The release automation reads this section to finalize release notes, bumping the project version and moving entries under the newly created version tag before publishing to GitHub.

Why does my automated version bump require a release guide?

A release guide is not strictly required. The automation defaults to Keep-a-Changelog and SemVer conventions when docs/guides/releasing.md is absent, ensuring deterministic and auditable version checks, changelog management, tagging, commits, and GitHub release creation.

Does this workflow handle setting up the initial release process?

No, this workflow handles cutting reproducible releases, not setting up the initial release process. It bumps versions, finalizes changelogs, tags, and creates GitHub releases, relying on existing setup configurations rather than establishing them.