ship

Automates the release workflow from branch merge through tests, review, version bump, and PR creation.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill ship-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/ship
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill ship-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping code involves a long, error-prone checklist: merging the base branch, running tests, reviewing the diff, bumping the version, updating the CHANGELOG, committing, pushing, and opening a PR. This Skill orchestrates that entire release pipeline so nothing gets skipped. ## Core Features & Use Cases - End-to-end release pipeline: Detects and merges the base branch, runs test suites, audits plan completion and test coverage, bumps VERSION, generates the CHANGELOG entry from commits, and creates the PR. - Multi-layer review gates: Dispatches adversarial review subagents, Codex structured review for large diffs, Greptile comment triage, and scope-drift detection before anything ships. - Platform adapters: Includes a dedicated Apple App Store / TestFlight release path driven by fastlane when the repo contains an Xcode project. - Use Case: After finishing a feature branch, tell the agent to ship it; the Skill runs tests, audits the diff against the original plan, reviews the changes, writes the CHANGELOG, and opens the PR with a full review report. ## Quick Start Ask the agent to ship the current branch and create a PR, then answer the review-gate questions it presents.

Frequently Asked Questions about ship

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

FAQPage Schema
How do I ship a feature branch and create a PR automatically?

Invoke the ship workflow with a phrase like "ship it" or "create a PR". It merges the base branch, runs tests, reviews the diff, bumps VERSION, updates the CHANGELOG, commits, pushes, and opens the PR in one guided pipeline.

What review steps run before code is shipped?

The workflow runs a Claude adversarial subagent on every diff, a Codex structured review for diffs over 200 lines, Greptile comment triage when a PR exists, plus plan-completion, test-coverage, and scope-drift audits.

Can this workflow release an iOS app to the App Store?

Yes. When the repo contains an .xcodeproj or .xcworkspace, an Apple release adapter takes over and drives fastlane (gym, pilot, deliver) for archiving, signing, TestFlight upload, and App Store submission.

What happens if the Codex CLI is not installed during review?

The preflight detects the missing or unauthenticated Codex CLI and falls back to a Claude adversarial subagent only, printing a note that the outside-model pass was skipped. Shipping continues without blocking.

Does the ship workflow handle incomplete plan items?

Yes. A plan-completion audit classifies every plan item as done, partial, not done, or unverifiable. Missing items trigger a gate asking whether to stop and implement them, defer them as follow-up TODOs, or drop them from scope.