ship

Run tests, review changes, bump versions, update changelog, and create a PR.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/francoisbgdw/claude-skills --skill ship-francoisbgdw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/francoisbgdw/claude-skills/tree/main/skills/ship
Command: npx skills add https://github.com/francoisbgdw/claude-skills --skill ship-francoisbgdw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Full release pipeline inspired by gstack's ship workflow. Takes code from current state to a merge-ready PR with tests, review, version bump, and changelog.

Core Features & Use Cases

  • Automated release pipeline: Runs tests, reviews changes, bumps version, updates changelog, and opens a PR.
  • Pre-flight checks: Ensures clean working tree and correct base branch before shipping.
  • End-to-end release: Handles patch, minor, and major bumps and creates a traceable release record.

Quick Start

Initiate the ship workflow to create a merge-ready release PR after passing tests.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate creating a merge-ready release PR with tests and changelogs?

Automating a merge-ready release PR involves running tests, reviewing changes, bumping versions, updating the changelog, and creating a pull request. This pipeline ensures releases are traceable and reproducible from feature branches.

What are pre-flight checks for shipping a git release?

Pre-flight checks for shipping a git release verify a clean working tree and confirm you are on the correct base branch. These checks prevent merging uncommitted changes or targeting the wrong branch.

How do I generate traceable version bumps for patch, minor, and major releases?

Traceable version bumps for patch, minor, and major releases are generated by automating the version increment alongside changelog maintenance. This creates a reproducible release record before opening a PR.

How does automated changelog maintenance work during a release?

Automated changelog maintenance during a release works by reviewing code changes, applying the appropriate version bump, and updating the changelog file before committing and pushing to create a merge-ready PR.

Can I run a full release pipeline directly from a feature branch?

Yes, you can run a full release pipeline from a feature branch. The workflow handles test execution, quick reviews, version bumps, and PR creation to ensure the release is merge-ready and traceable.