ship

Automate code review, testing, version bump, merge, and post-merge cleanup for pull requests.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires co-review, post-merge, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manages the process of transitioning a code branch or pull request from initial implementation to merged state, ensuring all steps including code review, testing, version bump, and cleanup are efficiently handled.

Core Features & Use Cases

  • Automated Co-review: Invokes the co-review process to ensure all approved changes are fixed before merging.
  • Local and CI Testing: Ensures that the test suite passes locally and the pull request has successful CI checks.
  • Version Bump: Handles version incrementing automatically when needed.
  • Merge Confirmation: Provides a merge confirmation gate for human approval.
  • Post-merge Cleanup: Automates cleanup tasks such as branch and worktree deletion and Jira status update.

Quick Start

Use the /ship command followed by the PR number or URL to initiate the merge process for the specified pull request.

Frequently Asked Questions about ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate the branch to merge workflow including code review and cleanup?

Automating the branch to merge workflow requires validating code review, local and CI testing, version bumping, and post-merge cleanup. You can trigger this entire sequence automatically by invoking the ship command with a specific pull request number or URL.

What is the best way to ensure pull requests pass co-review before merging?

To ensure pull requests pass co-review before merging, you need an automated gate that invokes the co-review process and verifies all approved changes are fixed. This guarantees only reviewed and validated code transitions to the merged state.

Does the automated merge workflow handle post-merge branch and worktree cleanup?

Yes, automated merge workflows can handle post-merge cleanup by automatically executing branch and worktree deletion. This cleanup is triggered immediately after the merge confirmation gate is passed and the pull request is successfully merged.

How do I add a merge confirmation gate for human approval in a CI/CD pipeline?

Adding a merge confirmation gate for human approval in a CI/CD pipeline provides a manual checkpoint after automated testing and version bumping. This gate ensures a human reviews the validated state before the final merge and subsequent automated cleanup tasks are executed.

Can I automatically update Jira status as part of my branch merge process?

You can automatically update Jira status as part of your branch merge process by integrating it into post-merge cleanup automation. After the merge confirmation gate is passed, the workflow executes branch deletion alongside the Jira status update.

Do I need continuous integration checks to automate my pull request merge process?

Yes, continuous integration checks are required to automate your pull request merge process. The workflow ensures the test suite passes locally and validates that the pull request has successful CI checks before proceeding to version bumping and merge confirmation.