ship

Merge base branches, run tests, and create release pull requests.

6|2|Updated Oct 18, 2021
One-click install
npx skills add https://github.com/jerrywu001/jerrywu001 --skill ship-jerrywu001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/jerrywu001/jerrywu001/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/jerrywu001/jerrywu001 --skill ship-jerrywu001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ship skill solves the problem of turning a local feature branch into a safely tested, review-ready pull request with consistent versioning and changelog updates.

Core Features & Use Cases

  • Automated merge + test workflow: Detects the base branch, merges it into your current branch, bootstraps/uses tests, runs them on the merged state, and stops on failures.
  • PR-ready change management: Reviews readiness, resolves simple merge conflicts when possible, generates changelog content from the diff, bumps VERSION appropriately, commits, pushes, and creates a PR.
  • Deployment/shipping trigger: Proactively supports requests to "ship", "deploy", "push to main", or "create a PR", and can run end-to-end without confirmation.

Quick Start

Ask the AI to ship your changes by saying: "Ship this branch and open a pull request with merged base, passing tests, and an updated changelog."

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 release pull request with passing tests and an updated changelog?

Automating a release pull request involves merging the base branch into your current branch, running test suites on the merged state, updating the changelog from the diff, and pushing the result. This workflow stops automatically if tests fail or merge conflicts occur.

What is the best way to merge a base branch and run tests before opening a pull request?

The best way to merge a base branch and run tests is to detect the base branch, merge it into your feature branch, and execute the appropriate test suites on the merged state. This ensures review readiness by gating the pull request on passing tests.

How does automated version bump and changelog generation work from a git diff?

Automated version bump and changelog generation works by inspecting the branch diff to generate changelog content and applying a deterministic version update. This happens after tests pass on the merged state, before committing and pushing the changes.

Can I resolve merge conflicts automatically when preparing a branch for a pull request?

You can resolve simple merge conflicts automatically during the base branch merge process. The workflow attempts to resolve these conflicts when possible, but it stops entirely if it encounters complex conflicts or test failures to ensure safe operations.

Does this release workflow run end-to-end without manual confirmation?

This release workflow can run end-to-end without confirmation when triggered by requests to ship, deploy, or push to main. It handles branch detection, commit, push, and pull request creation autonomously while logging telemetry data.

What happens to the release workflow if the test suite fails after merging the base branch?

If the test suite fails after merging the base branch, the release workflow stops immediately. This controlled failure handling prevents broken code from being committed, pushed, or submitted as a review-ready pull request.