ship

Merge base into feature branches, run tests, bump VERSION, update CHANGELOG, and open a PR.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/studyzy/dev-agent-protocol --skill ship-studyzy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/studyzy/dev-agent-protocol/tree/main/.claude/skills/gstack/ship
Command: npx skills add https://github.com/studyzy/dev-agent-protocol --skill ship-studyzy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ship automation reduces the manual overhead of promoting code from feature branches to release-ready state by coordinating tests, merges, version bumps, and PR creation.

Core Features & Use Cases

  • End-to-end shipping: detect base branch, merge, run tests, bump VERSION, update CHANGELOG, commit, push, and create a PR.
  • Proactive guidance: suggests when code is ready to deploy and helps plan releases.
  • Use Case: When preparing a release, trigger the ship workflow to validate changes, update release notes, and open a PR for review.

Quick Start

Trigger the /ship workflow on a feature branch to automatically test, merge, bump version, update changelog, commit, push, 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 git release workflows from testing to PR creation?

Automating git release workflows involves detecting the base branch, merging it into your feature branch, running tests, bumping the VERSION file, updating the CHANGELOG, and pushing a commit to open a PR. This coordinates the entire shipping process end-to-end.

What is the best way to update VERSION and CHANGELOG files before opening a pull request?

The best way to update VERSION and CHANGELOG files is to automate the process during your release workflow. The system reviews your branch diffs, applies the appropriate version bump, generates changelog entries, commits these changes, and pushes them before creating the PR.

Can I run tests and merge base branches into feature branches automatically?

Yes, you can run tests and merge base branches into feature branches automatically. The workflow detects the base branch, performs the merge, executes your test suite, and validates the changes before proceeding with versioning and PR creation.

Does the ship workflow require any specific CI dependencies or components?

The ship workflow does not require specific CI dependencies or external components. It operates as a standalone skill using built-in tools like Bash, Read, Write, Edit, Grep, and Glob to execute git commands, manage files, and create pull requests directly.

When should I not use an end-to-end shipping automation workflow?

You should not use end-to-end shipping automation if your repository lacks a VERSION file, requires manual changelog curation, or needs human approval before merging the base branch, as this workflow is designed for deterministic, CI-like release execution.

How does automated changelog management work during a git release?

Automated changelog management works by reviewing the diff between the base and feature branches. After bumping the version, the workflow appends the detected changes to the CHANGELOG file, commits the update, and includes it in the final pull request for review.