ship-workflow

Automate the end-to-end release process from feature branch to pull request.

310|45|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/Mathews-Tom/armory --skill ship-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-workflow
Source: https://github.com/Mathews-Tom/armory/tree/main/skills/ship-workflow
Command: npx skills add https://github.com/Mathews-Tom/armory --skill ship-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ship Workflow automates the end-to-end release pipeline from feature branch to PR, eliminating manual coordination and reducing release risk.

Core Features & Use Cases

  • Pre-flight checks to ensure the branch is release-ready and code is clean.
  • Merge main, run tests, perform version bump, update changelog, and create bisectable commits.
  • Open a pull request with a clear, traceable history and remediation guidance when failures occur.

Use Case: When a feature is ready for release, run ship-workflow to automatically validate, package, and ship the change.

Quick Start

Trigger the ship-workflow on a release-ready feature branch to start the end-to-end release process.

Frequently Asked Questions about ship-workflow

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

FAQPage Schema
How do I automate version bumps and changelog updates for a release pull request?

To automate a release pull request, this Skill detects your project's version strategy, performs the version bump, updates the changelog, and opens a PR with a traceable commit history. It eliminates manual coordination by handling pre-flight checks and merging main automatically.

How does an automated release workflow handle failing tests before opening a pull request?

When automated release tests fail, the workflow stops immediately and provides remediation instructions rather than opening a pull request. This ensures release readiness by preventing broken code from being packaged or shipped to the main branch.

Can I use automated release automation across diverse project configurations without manual setup?

Yes, you can use this release automation across diverse project configurations because it dynamically detects test commands and versioning strategies directly from your project configuration. It requires no dependencies or components to function.

What is the best way to ensure a feature branch is release-ready before running CI-CD processes?

The best way to ensure release readiness is running pre-flight checks that validate clean code and branch state before proceeding. This release workflow validates the branch, merges main, and runs tests to guarantee only passing changes are shipped.

Why does my automated release pull request fail during version bump and how do I fix it?

An automated release pull request fails during version bump if pre-flight checks detect unclean code or if tests fail after merging main. The workflow stops and provides specific remediation instructions to fix the failing tests or configuration issues.