ship

Coordinate base-branch detection, tests, diff review, version bumps, and PR creation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cvenwu/AiFlow --skill ship-cvenwu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/cvenwu/AiFlow/tree/main/skills/gstack/ship
Command: npx skills add https://github.com/cvenwu/AiFlow --skill ship-cvenwu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the end-to-end process of shipping code changes by detecting the base branch, running the test suite, reviewing diffs, bumping the version, updating the changelog, committing, pushing, and opening a PR. It ensures changes are validated and traceable before they leave the repository.

Core Features & Use Cases

  • Detects the base branch and prepares a merge-ready path for review.
  • Runs tests and validates diffs to catch regressions early.
  • Bumps VERSION, updates CHANGELOG, commits, and creates a PR for review.
  • Applicable for standard release cycles, hotfix merges, and automated release workflows.

Quick Start

Instruct the agent to run the ship workflow on the current branch to 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 creating a pull request after running tests and bumping versions?

The ship workflow detects the base branch, runs your test suite, reviews diffs, bumps the VERSION file, updates the CHANGELOG, commits, pushes, and opens a pull request. This ensures changes are validated and traceable before leaving the repository.

What is the safest way to automate a hotfix merge and release workflow?

The ship skill handles hotfix merges by running tests, reviewing diffs, bumping versions, updating the changelog, and creating a PR. This ensures hotfixes are validated and traceable before they leave the repository.

Does this PR automation workflow require a specific CI-CD platform to run?

No specific CI-CD platform is required. The ship workflow operates independently by detecting the base branch, running tests, bumping versions, and using git commands to commit, push, and open a pull request for review.

Can I use branch management automation to update the changelog and version simultaneously?

Yes, the ship workflow automatically bumps the VERSION, updates the CHANGELOG, and includes these changes in the commit before pushing and creating a pull request. This ensures version tracking and changelog updates happen simultaneously.

Why should I use a pull request workflow instead of pushing directly to the base branch?

Using a pull request workflow instead of pushing directly enforces safe practices by validating tests and reviewing diffs before release. The ship workflow ensures changes are traceable and peer-reviewed by generating a PR rather than direct pushes.