ship

Automates a feature branch's test, version, changelog, and PR workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates the repetitive, error-prone steps required to land a feature branch: detect the base branch, run tests, review diffs, bump versions, update changelogs, commit, push, and create a pull request so engineers can ship reliably and quickly.

Core Features & Use Cases

  • Detect & Merge Base: Finds the repository's base branch, merges it into the feature branch, and reports conflicts.
  • Run Tests & Gates: Executes the test suite and enforces safety gates for failing tests or low coverage before proceeding.
  • Release Prep: Bumps VERSION (micro/patch by default), auto-generates CHANGELOG entries from the diff, and creates tidy, bisectable commits.
  • PR Creation: Pushes changes and opens a pull request with a summary of changes, test results, version bump, and any review findings.
  • Use Case: From a feature branch with staged changes, run this to produce a merge-ready PR with version and changelog updates, saving manual checklist work.

Quick Start

Run the ship workflow to detect the base branch, run tests, bump VERSION, update CHANGELOG, commit and push changes, and open a pull request.

Frequently Asked Questions about ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate git merge, test, version bump, and pull request creation for a feature branch?

To automate git merge, test, version bump, and pull request creation, you can use a workflow that detects the base branch, merges it, runs test suites, updates VERSION and CHANGELOG, and pushes a merge-ready pull request with a summary of changes.

How does automated changelog generation work from a git diff before opening a PR?

Automated changelog generation from a git diff works by analyzing the feature branch changes, auto-generating CHANGELOG entries based on the diff, and bundling them into a tidy, bisectable commit before pushing and opening the pull request.

Can I run tests and enforce safety gates before bumping a version and merging?

Yes, you can run tests and enforce safety gates before bumping a version and merging. The workflow executes the test suite and blocks progression by enforcing safety gates for failing tests, low coverage, or major version bumps.

What happens when there are merge conflicts between my feature branch and the base branch?

When there are merge conflicts between your feature branch and the base branch, the automated shipping workflow attempts to merge the base branch into the feature branch and reports the conflicts so you can resolve them before proceeding.

What is the best way to prepare a merge-ready pull request with version and changelog updates?

The best way to prepare a merge-ready pull request with version and changelog updates is to run an end-to-end shipping workflow that bumps VERSION, auto-generates CHANGELOG entries, commits, pushes, and outputs a PR URL with test results and review findings.

Does this automated shipping workflow require CI pipelines or external dependencies to function?

No, this automated shipping workflow does not require external dependencies or pre-configured CI pipelines to function. It performs git operations, runs test suites, handles version bumps, and creates pull requests directly within the repository environment.