ship

Automate code shipping from git worktree to main branch with PRs.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/janewilkin/bismuth-digital-llc-web --skill ship-janewilkin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/janewilkin/bismuth-digital-llc-web/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/janewilkin/bismuth-digital-llc-web --skill ship-janewilkin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh, ruff, mypy, work-queue.sh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the entire process of committing code changes, creating a pull request, merging it, and syncing your local repository, all with a single command.

Core Features & Use Cases

  • End-to-End Workflow: Manages the complete lifecycle from staged changes to deployed code.
  • Automated Versioning: Integrates with a /version skill to handle semantic version bumps.
  • CI Parity: Ensures code passes linting and type checks locally before creating a PR.
  • Use Case: After completing a feature in a git worktree, you can use this skill to commit, version, push, create a PR, merge it, and update your main development branch without manually running multiple git and GitHub CLI commands.

Quick Start

Use the ship skill to commit, version, and merge your current changes.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate git worktree to main branch deployment with GitHub CLI?

Automating git worktree to main branch deployment is handled by committing, version bumping, pushing, creating, and merging pull requests using git and gh CLI commands in a single workflow. This skill orchestrates that end-to-end lifecycle automatically.

How do I skip CI checks for docs-only changes in a pull request?

To skip CI checks for docs-only changes in a pull request, the commit requires a `[skip ci]` flag. This skill automatically detects documentation updates and applies the necessary flag to bypass continuous integration pipelines.

What's the best way to manage semantic versioning and PR merges in one step?

Managing semantic versioning and PR merges in one step is achieved by integrating a separate versioning skill before pushing to a remote repository. The workflow bumps versions, creates the pull request, and merges it sequentially.

Do I need to run ruff and mypy locally before creating a pull request?

You need to run ruff and mypy locally to ensure code passes linting and type checks before creating a pull request. This workflow enforces CI parity by validating your Python code locally before opening a PR.

Can I sync my local main branch automatically after merging a pull request?

You can sync your local main branch automatically after merging a pull request. Once the remote merge completes, this workflow updates your local repository to reflect the newly deployed main branch state.

Why does code shipping from a worktree fail during Git or GitHub CLI operations?

Code shipping from a worktree can fail during Git or GitHub CLI operations due to local merge conflicts or authentication errors. This workflow provides robust error handling for common gh and git command failures to safely halt the process.