ship

Automate the ship workflow from branch merge to PR creation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the ship workflow, handling the entire process from merging the base branch to opening a PR, so release-ready code can be shipped with minimal manual steps.

Core Features & Use Cases

  • Auto-detect base and target branches, merge safely, and run the full test suite.
  • Bump VERSION, update CHANGELOG, commit changes, push, and create a PR automatically.
  • Proactively suggest deployment/shipping actions when the code is ready or when asked.

Quick Start

Trigger the automation by saying ship, deploy, push to main, or create 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 a git workflow from merging the base branch to creating a pull request?

Automate a git workflow by merging the base branch, running tests, bumping VERSION, updating CHANGELOG, committing, pushing, and opening a PR. Trigger the automation by saying ship, deploy, push to main, or create a PR.

What's the best way to auto-bump VERSION and update CHANGELOG before pushing a release?

Auto-bump VERSION and update CHANGELOG by triggering the ship workflow, which detects branches, runs tests, reviews diffs, and commits changes before pushing. This handles the entire release preparation process automatically.

Can I use shell utilities and git to run an end-to-end CI/CD shipping process?

Yes, you can run an end-to-end CI/CD shipping process using shell utilities and git. The workflow integrates with CI/CD and PR platforms, requiring Bash, Read, Write, Edit, Grep, and Glob tools to complete shipping.

Do I need gstack tooling to automate pull request creation and deployment?

Yes, you need gstack tooling including Bash, Read, Write, Edit, Grep, Glob, Agent, AskUserQuestion, and WebSearch. These tools support the full ship workflow from branch detection to PR creation and deployment suggestions.

How does a PR-based release workflow handle diff review and test execution?

A PR-based release workflow handles diff review and test execution by automatically merging the base branch, running the full test suite, reviewing code diffs, and then bumping VERSION before committing and pushing changes.

When should I use automated deployment suggestions in a release workflow?

Use automated deployment suggestions when code is release-ready or when explicitly asked. The ship workflow proactively suggests deployment and shipping actions after completing tests, diff review, VERSION bumps, and CHANGELOG updates.