ship

Orchestrates a staged pipeline from working tree changes to a green, mergeable GitHub pull request.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/nsollazzo/ship-kit --skill ship-nsollazzo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/nsollazzo/ship-kit/tree/main/.agents/skills/ship
Command: npx skills add https://github.com/nsollazzo/ship-kit --skill ship-nsollazzo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting a finished change from your working tree to an approved, CI-green, mergeable pull request involves many manual steps — cleanup, verification, review, committing, branch naming, PR creation, and chasing review feedback. This Skill automates that entire sequence as one gated pipeline so nothing is skipped or silently broken. ## Core Features & Use Cases - Staged pipeline orchestration: Chains simplify → verify → code-review → smart-commit → branch hygiene → PR → babysit → reflect, with each stage delegated to a dedicated bundled skill and a resumable state file. - Safety gates and flags: A single human checkpoint before pushing, plus --fast, --merge, --no-verify, and --yolo flags to control depth and hands-off behavior; failed stages halt loudly instead of being skipped silently. - End-to-end PR lifecycle: Drives the PR to fresh APPROVED + CI green + mergeable via the babysit stage, and optionally squash-merges and monitors the triggered deployment with --merge. - Use Case: You finished a bug fix on a feature branch. Invoke the ship pipeline to clean up the diff, run tests, apply review fixes, commit with conventional messages, open the PR, and let it babysit the PR until it is green and mergeable. ## Quick Start Ask the agent to ship the current change, for example: "Ship this change" or "Ship it with --merge to squash-merge and monitor the deployment once it goes green."

Frequently Asked Questions about ship

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

FAQPage Schema
How do I turn local changes into a pull request automatically?▼

Invoke the ship pipeline, which runs simplify, verify, code-review, and smart-commit stages, then pushes the branch and opens a PR with gh pr create. It pauses at one checkpoint for your confirmation before pushing unless you pass --merge or --yolo.

How do I get a GitHub PR to approved and CI green without manual polling?▼

The ship pipeline's Stage 8 invokes the bundled babysit skill, which loops on the PR: verifying each review finding against the code, fixing valid ones, replying on threads, and pushing until the PR is freshly approved, all CI checks pass, and it is mergeable.

Does the ship pipeline merge the pull request automatically?▼

No, by default it stops at approved, CI green, and mergeable, leaving the merge to a human. Passing --merge authorizes a squash-merge followed by deployment monitoring via the merge-and-monitor skill.

Can I skip code review or verification for small changes?▼

Yes, --fast skips the simplify and code-review stages, and --no-verify skips the runtime verification stage, though the rebase-against-base check still runs. Skipped stages are always named explicitly in the final summary.

What happens if a pipeline stage fails or the run is interrupted?▼

A failed stage halts the pipeline with the failure evidence rather than continuing. The skill writes a .ship-state.json file after each stage, so a later invocation on the same branch can offer to resume from the next unfinished stage.