ship

Runs tests, code review, version bump, changelog, git tag, and push for releases.

6|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/greglas75/zuvo --skill ship-greglas75
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/greglas75/zuvo/tree/main/skills/ship
Command: npx skills add https://github.com/greglas75/zuvo --skill ship-greglas75

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping a release involves many error-prone manual steps — running tests, reviewing the diff, bumping versions, writing changelogs, tagging, and pushing — and skipping any of them leads to broken or untraceable releases. ## Core Features & Use Cases - Automated release pipeline: Runs the test suite with failure triage, scales code review depth by diff size, bumps the version, generates a changelog, creates a git tag, and pushes or opens a PR. - Branch-aware flow detection: Auto-detects direct push on main versus PR flow on feature branches, resolves the correct base ref, and detects half-completed or untagged prior releases. - Safety gates: Mandatory review thresholds, secret scanning before push, and strict staging rules prevent force-pushes, unreviewed large diffs, and accidental commits. - Use Case: After finishing a feature branch, invoke the skill to run tests, review the diff against the merge base, bump the minor version, tag the release, and open a PR — all in one command. ## Quick Start Ask the assistant to ship the current branch with an automatic patch version bump and push the release.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate a release with version bump and git tag?

Invoke the ship skill on your branch and it runs tests, reviews the diff, bumps the version, generates a changelog, creates an annotated git tag, and pushes. Use flags like patch, minor, or major to control the bump type explicitly.

How does the skill decide between pushing directly and creating a PR?

It detects the current branch: on main, master, trunk, or develop it uses direct flow with tag and push, while any other branch triggers PR flow targeting the repository's default branch. Repo-level conventions in project docs override the branch-name heuristic.

Can I skip the code review step when shipping a small change?

No, there is no review-skip flag. Small diffs under 20 lines automatically take a fast review path via the threshold table, but review itself is mandatory and unskippable for all release sizes.

What happens if tests fail during the release pipeline?

Failures are triaged into new regressions, pre-existing failures, or environment issues. New regressions are fixed in-run, trivially fixable pre-existing failures are fixed in a separate commit, and environment failures trigger a capped re-run before the pipeline continues.

Does the ship skill support dry runs before executing?

Yes, the --dry-run flag walks through every phase printing what would happen — branch, flow, diff size, review depth, bump type, staged files, tag name, and push target — without executing anything.

What happens if a previous release was committed but never tagged?

The skill detects half-completed releases by scanning recent history for untagged release commits. It skips re-bumping, reconstructs the missing tag at the original commit, and resumes the pipeline at the tag and push steps.