ship

Automates the shipping workflow by merging the base branch, testing, bumping VERSION, updating CHANGELOG, committing, pushing, and creating a PR.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/yahav123147/paid-ads-cro-skills --skill ship-yahav123147
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/yahav123147/paid-ads-cro-skills/tree/main/skills/ship
Command: npx skills add https://github.com/yahav123147/paid-ads-cro-skills --skill ship-yahav123147

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reliably ship changes by turning “we’re ready” into a disciplined workflow that detects a correct base branch, merges it, runs tests, reviews the diff, bumps the version, updates the changelog, commits, pushes, and opens a PR.

Core Features & Use Cases

  • Merge base branch safely: Detects the base branch (or default) and merges it into your working branch before shipping.
  • Run tests and review the diff: Executes the project test suite and inspects what will change, so you do not ship an accident.
  • Versioning and release hygiene: Bumps VERSION, updates CHANGELOG, then commits and pushes changes to create a PR.

Quick Start

Tell the AI: Ship my changes by merging the base branch, running tests, reviewing the diff, bumping VERSION, updating CHANGELOG, committing, pushing, and creating a PR.

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 pull request after updating the changelog and bumping the version?

To automate creating a pull request after updating the changelog and bumping the version, you can use a release workflow that merges the base branch, runs tests, updates VERSION and CHANGELOG files, commits, pushes, and opens the PR automatically.

What is the best way to ensure my branch is ready to ship before opening a pull request?

The best way to ensure your branch is ready to ship is to execute a release workflow that merges the base branch, runs the project test suite, and reviews the diff to prevent shipping accidental or broken changes before opening a pull request.

How does merging the base branch before running tests prevent release workflow errors?

Merging the base branch before running tests prevents release workflow errors by integrating the latest upstream changes into your working branch, ensuring the test suite executes against the current codebase before you bump the version and push.

Can I automatically bump the VERSION and update the CHANGELOG when pushing code to main?

Yes, you can automatically bump the VERSION and update the CHANGELOG when pushing code by triggering a workflow that performs these updates, commits the changes, pushes to your branch, and creates a pull request to merge into main.

Do I need a specific CI pipeline to run tests and review the diff before deploying?

You do not need a specific CI pipeline to run tests and review the diff before deploying; a local release workflow can execute the test suite, inspect the diff, bump the version, and generate the pull request directly from your working branch.

Why does my automated release workflow fail when the base branch is not merged first?

An automated release workflow fails when the base branch is not merged first because unmerged upstream changes can cause test failures or conflicts during the diff review, preventing a clean version bump and pull request creation.