ship

Merge the base branch, run tests, and create a pull request.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end code shipping by merging the base branch, running tests, and preparing a pull request.

Core Features & Use Cases

  • Base-branch detection and merge orchestration: ensures code is merged into the correct base automatically with checks.
  • Test execution and diff review: runs the project tests and highlights code changes for quick review.
  • Version bump and changelog updates: increments version numbers and records changes before pushing.
  • PR creation and push governance: commits, pushes, and opens a PR according to policy.
  • Proactive invocation rules: can be triggered when user signals readiness or asks about deployment, with safeguards to avoid premature actions.

Quick Start

Ask the ship skill to merge the base branch, run tests, bump VERSION, update CHANGELOG, commit, push, and create 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 running tests and merging the base branch?

Automating pull request creation involves detecting the base branch, merging it, executing tests, bumping the version, and updating the changelog before pushing. This orchestrates the entire workflow to ensure the PR is prepared with validated changes and proper documentation.

What is the best way to ship code to main while ensuring CI tests pass?

Shipping code to main safely requires merging the base branch first to resolve conflicts, then executing CI tests locally. If tests pass, you commit changes, push, and open a PR for review, ensuring the main branch remains stable and governed.

Can I automatically update the changelog and bump the version when preparing a git deploy?

Yes, you can automatically update the changelog and bump the version when preparing a git deploy. Automating these steps records changes and increments the version number before pushing, ensuring the repository state accurately reflects the new release.

How does base-branch detection work when creating a PR in a collaborative repository?

Base-branch detection identifies the correct target branch for merging in a collaborative repository. It ensures code is merged into the appropriate base automatically with checks, preventing accidental pushes to the wrong branch and maintaining workflow governance.

What are the limitations of automating git merge and deploy workflows with proactive invocation?

Automating git merge and deploy workflows with proactive invocation includes safeguards to avoid premature actions. It is limited by governance rules that require explicit readiness signals from the developer, preventing unintended deployments or unreviewed pushes to main.