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.