ship

Merge base branches, run tests, review diffs, and generate pull requests.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/1337hero/claude-toolkit --skill ship-1337hero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/1337hero/claude-toolkit/tree/main/skills/ship
Command: npx skills add https://github.com/1337hero/claude-toolkit --skill ship-1337hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end software shipping by merging base branches, running tests, reviewing diffs, optionally bumping versions, and generating PRs.

Core Features & Use Cases

  • Pre-flight checks to determine base branch and ensure proper branch on which to ship
  • Merge base branch and run tests against merged state
  • Lightweight diff review and a concise ship summary
  • Optional version bump and changelog handling
  • Commit, push, and create a PR with a properly formatted message

Quick Start

Invoke the ship workflow to merge the base branch, run tests, review diffs, 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 a base branch?

Yes, automated diff review is included as part of the shipping workflow. It performs a lightweight diff review and generates a concise ship summary before pushing your code and opening a pull request.

Does the automated shipping workflow handle version bumping and changelog updates?

Yes, the automated shipping workflow optionally handles version bumping and changelog updates. It applies these changes alongside diff analysis and conventional commits before pushing and opening a pull request.

What are the pre-flight checks needed before shipping code from a feature branch?

Pre-flight checks determine the correct base branch and ensure you are on a proper feature branch before shipping. This guarantees deterministic branching and validates your repository state prior to merge and test execution.

Can I use this workflow to run tests against the merged state of my base branch?

Yes, you can use this workflow to run tests against the merged state. It merges the base branch into your feature branch and orchestrates test execution to validate the integrated code before creating a pull request.

What is the best way to ensure conventional commits before opening a pull request?

The best way to ensure conventional commits is using an automated shipping workflow that formats commit messages automatically. It applies pre-flight checks, merges base branches, runs tests, and formats commits before pushing and opening a PR.