ship

Merge the base branch, run tests, update VERSION, and open a PR.

2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/nicholaslocascio/x-claw-studio --skill ship-nicholaslocascio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/nicholaslocascio/x-claw-studio/tree/main/skills/gstack/ship
Command: npx skills add https://github.com/nicholaslocascio/x-claw-studio --skill ship-nicholaslocascio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ship workflow automation streamlines the end-to-end process of integrating code changes by automatically merging the base branch, running tests, bumping version numbers, updating the changelog, committing, and opening a pull request.

Core Features & Use Cases

  • Automates base-branch merging, test execution, and version bumps as part of a pre-merge flow.
  • Generates changelog entries and creates a PR to surface changes for review.
  • Provides a deterministic, bisectable commit history suitable for traceability and audits.

Quick Start

Trigger the ship workflow on a feature branch to automatically merge the base, run tests, update versioning, and open 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 git workflow tasks like running tests and opening a PR before merging?

You can automate git workflow tasks by merging the base branch, running tests, updating the version, and opening a pull request. This ensures changes are validated end-to-end before integration.

What is a deterministic commit history and how does it help code integration?

A deterministic commit history provides a bisectable record of changes suitable for traceability and audits. It enforces consistent versioning rules and changelog generation during the pre-merge process.

How do I automatically generate changelog entries and bump version numbers on a feature branch?

To automatically generate changelog entries and bump version numbers, trigger an automated ship workflow on your feature branch. The workflow executes updates deterministically before committing and opening a pull request.

Can I use automated versioning and testing workflows in local-dev pipelines?

Yes, automated versioning and testing workflows are designed for use in local-dev pipelines. They enforce deterministic commits and validate changes end-to-end before opening a pull request for integration.

What is the best way to ensure code changes are validated end-to-end before integration?

The best way to validate changes end-to-end is using an automated workflow that merges the base branch, runs tests, and generates a changelog. This guarantees deterministic commits and versioning before opening a PR.