ship

Automate code release by merging, testing, bumping VERSION, updating CHANGELOG, and creating a PR.

2|1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/vnmoorthy/Skylog --skill ship-vnmoorthy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/vnmoorthy/Skylog/tree/main/.claude/skills/gstack/ship
Command: npx skills add https://github.com/vnmoorthy/Skylog --skill ship-vnmoorthy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ship skill automates the end-to-end release workflow by coordinating base-branch detection, merging, test execution, diff review, version bump, changelog update, and PR creation.

Core Features & Use Cases

  • Proactive release orchestration: detects when code is ready, runs validation, and prepares a PR without pushing directly.
  • Versioning and changelog automation: bumps VERSION and updates CHANGELOG to reflect changes.
  • Gate-kept PR creation: generates and pushes a PR after successful checks, coordinating with Git workflows.

Quick Start

Trigger the ship workflow on a ready-to-merge branch to automatically run tests, bump the version, update the changelog, and open a PR.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I automate creating a PR and bumping the version before merging to main?▼

You can automate PR creation and version bumping by using a release workflow that detects base-branch changes, runs tests, bumps VERSION, updates CHANGELOG, and opens a PR with user confirmation before pushing.

What is an end-to-end code shipping workflow that includes test orchestration and changelog management?▼

An end-to-end code shipping workflow coordinates merging, running tests, reviewing diffs, bumping VERSION, updating CHANGELOG, and creating a PR, ensuring all validation checks pass before committing changes.

How do I prevent accidental direct pushes to main when automating a release?▼

To prevent accidental direct pushes to main, use a gate-kept release flow that requires user confirmation before pushing, ensuring tests pass and a PR is generated instead of pushing directly.

Can I automatically update the CHANGELOG and generate a PR at the same time?▼

Yes, you can automatically update the CHANGELOG and generate a PR simultaneously by triggering a release workflow that bumps the version, updates the changelog, commits, pushes, and opens a PR after successful checks.

Does automated release orchestration work with existing Git branch workflows?▼

Automated release orchestration works with Git branch workflows by detecting base-branch changes, merging, reviewing diffs, and coordinating PR creation while applying safety gates to prevent unconfirmed direct pushes.

What are the limitations of automating code shipping with version and changelog management?▼

Automating code shipping with version and changelog management requires user confirmation before pushing and relies on successful test orchestration, meaning it will not bypass safety gates or push directly without explicit approval.