skills.rest
shenxingy
shenxingyCOMMUNITY
Explore all skills by this author →
Website𝕏@alexshen_devGitHub

ship

Run tests, bump versions, update CHANGELOG, commit, and create a PR.

8|5|Updated Feb 18, 2026
Search Tags:#git automation#pull request#CHANGELOG#version bump#release pipeline#test gating#CI readiness
One-click install
npx skills add https://github.com/shenxingy/Clade --skill ship-shenxingy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/shenxingy/Clade/tree/main/configs/skills/ship
Command: npx skills add https://github.com/shenxingy/Clade --skill ship-shenxingy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates risky or inconsistent release behavior by enforcing a deterministic, end-to-end pipeline that validates tests and review readiness before bumping versions, updating changelogs, and creating a PR.

Core Features & Use Cases

  • Hard-gated release workflow: runs tests, enforces a review gate (VERIFY.md when available), bumps version, updates CHANGELOG, commits, and opens a PR.
  • Release-grade safety checks: blocks on failures such as dirty working tree or failed tests, and can run as a dry run.
  • Project-type awareness: detects version sources for Python (pyproject.toml/setup.py) and Node (package.json) and proceeds accordingly.

Quick Start

Run /ship to perform a full release pipeline that runs tests, updates version and CHANGELOG, commits the changes, and opens 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 release pipeline with version bump and pull request?▼

Automate a git release pipeline by running tests, validating a review gate, bumping versions, updating the CHANGELOG, committing changes, and opening a PR. This enforces consistent, repeatable release mechanics while preventing accidental mid-session commits.

Does automated release automation work with both Python and Node repositories?▼

Release automation works with both Python and Node repositories by detecting version sources in pyproject.toml, setup.py, and package.json. It adjusts the version bump process accordingly to ensure project-type awareness during the release pipeline.

Can I run a release pipeline dry run without creating a pull request?▼

You can run a release pipeline dry run and control PR creation using specific flags. This allows you to validate the end-to-end workflow, including tests and version bumps, without committing changes or opening an actual pull request.

Why does my release pipeline stop before bumping the version number?▼

Your release pipeline stops before bumping the version number if it encounters a dirty git working tree or failed tests. It requires a clean working tree and halts immediately on test failures to enforce release-grade safety checks.

What is a hard-gated release workflow and when do I need it?▼

A hard-gated release workflow is a deterministic pipeline that validates tests and review readiness, using a VERIFY.md file when available, before proceeding. You need it to eliminate risky or inconsistent release behavior and prevent accidental mid-session commits.

Related Skills

Explore More Software Engineering Skills→
VamdawnVamdawn

semver-release

Analyze commit history to infer semantic versions and update version files and changelogs.

Community
Advanced
1a35e11a35e1
2

release

Automate npm release workflows with version bumps, changelogs, and GitHub releases.

Community
Advanced
pglejzerpglejzer
95

repo-maintenance

Orchestrate an eight-stage repository health pipeline and enforce quality gates.

Community
Advanced
ormastesormastes

Release Skill

Automate version bumping and release preparation for the Simple Language compiler.

Community
Intermediate