ship

Merge base branch, run tests, bump VERSION, update CHANGELOG, commit, push, and open a PR.

Updated May 7, 2026
One-click install
npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill ship-tumeloramaphosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/TumeloRamaphosa/StudEx-Valley-OS/tree/main/.claude/skills/gstack/ship
Command: npx skills add https://github.com/TumeloRamaphosa/StudEx-Valley-OS --skill ship-tumeloramaphosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the risk and friction of pushing code by coordinating the full “ready to ship” workflow end to end, so your repo gets consistent merges, validated changes, and an audit-friendly release trail.

Core Features & Use Cases

  • Base-branch merge + conflict-aware review: detects and merges the base branch before shipping so your final diff is accurate against the latest upstream.
  • Test-gated integrity: runs the project’s tests and only proceeds when the quality gate is satisfied.
  • Release hygiene automation: bumps VERSION, updates CHANGELOG, commits the result, and pushes to the appropriate branch while preparing a PR flow.
  • Use when you’re ready to deploy: best for cases when you say code is ready, ask to deploy, want to push to main, or request a PR.

Quick Start

Ask the AI: Ship this change by merging base, running tests, bumping VERSION, updating CHANGELOG, committing, and creating the PR for review.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate git pull requests after passing CI tests and updating the changelog?▼

To automate pull requests after CI tests, the ship workflow detects and merges the base branch, runs the test gate, bumps VERSION, updates CHANGELOG, commits, pushes, and opens a PR automatically.

What is the best way to prepare a reviewable diff before pushing code to main?▼

The best way to prepare a reviewable diff is merging the base branch first. This workflow detects and merges upstream changes before shipping, ensuring your final diff remains accurate and conflict-free against the latest code.

Does this release workflow run project tests before bumping the version?▼

Yes, the release workflow enforces test-gated integrity. It runs the project's tests and only proceeds to bump VERSION, update CHANGELOG, and push the commit when the quality gate is satisfied.

When should I use an automated deployment workflow for git pull requests?▼

Use an automated deployment workflow when you are ready to deploy, push to main, merge and push, or create a pull request after code changes are ready. It coordinates the full ready-to-ship process end to end.

Can I push to main without manually handling version bump and changelog updates?▼

Yes, you can push to main without manual handling. This workflow automates release hygiene by bumping VERSION, updating CHANGELOG, committing the result, and pushing to the appropriate branch while preparing a PR for review.