skills.rest
tgmarinho
tgmarinhoCOMMUNITY
Explore all skills by this author →
Website𝕏@tgmarinhoGitHub

ship

Automates the git ship workflow from branch merge through pull request creation.

Updated May 15, 2026
Search Tags:#automation#git#changelog#pull request#deploy#release workflow#version bump
One-click install
npx skills add https://github.com/tgmarinho/canetaco --skill ship-tgmarinho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/tgmarinho/canetaco/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/tgmarinho/canetaco --skill ship-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping code involves a repetitive, error-prone sequence: 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 workflow so nothing gets skipped. ## Core Features & Use Cases - End-to-end ship pipeline: Detects and merges the base branch, runs tests, reviews the diff, bumps VERSION, updates CHANGELOG, commits, pushes, and creates a PR in one guided flow. - Interactive decision gates: Uses structured AskUserQuestion decision briefs with recommendations, tradeoffs, and completeness scores before destructive or high-stakes steps. - Session and checkpoint management: Supports continuous WIP checkpoint commits that get squashed into clean commits at ship time, plus context recovery across sessions. - Use Case: You finish a feature branch and say "ship it" — the Skill merges main, runs the test suite, walks you through the diff review, bumps the version, and opens the pull request. ## Quick Start Tell the assistant to ship the current branch and create 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 ship code and create a pull request automatically?▼

Invoke the ship workflow by saying ship it, create a PR, or push to main. The Skill merges the base branch, runs tests, reviews the diff, bumps VERSION, updates the CHANGELOG, commits, pushes, and opens the pull request in sequence.

What does the ship workflow do before creating a PR?▼

Before opening the PR it detects and merges the base branch, runs the test suite, walks through a diff review, bumps the VERSION file, and updates the CHANGELOG. Each high-stakes step is gated by an interactive decision prompt with a recommendation.

Can I use the ship skill in plan mode?▼

Yes, the Skill defines plan-mode-safe operations and treats its file as executable instructions during plan mode. Commands marked as plan mode exceptions still run, and ExitPlanMode is called only after the workflow completes.

What happens if AskUserQuestion is unavailable when shipping?▼

The workflow stops and reports BLOCKED — AskUserQuestion unavailable. It does not silently auto-decide or write decisions to the plan file, since interactive gates are required for destructive shipping steps.

How does continuous checkpoint mode work with shipping?▼

When checkpoint_mode is continuous, the Skill auto-commits logical units with WIP prefixes and structured context trailers during work. At ship time these WIP commits are squashed into clean commits before the push and PR creation.

Related Skills

Explore More Software Engineering Skills→
raineraine
2.1k

merge

Commit staged changes, rebase onto the configured base branch, and merge with cleanup.

Community
Basic
no-sessionno-session
107

land-and-deploy

Merges GitHub pull requests, waits for CI and deploy, and verifies production health.

Community
Advanced
sheawinklersheawinkler
78

requesting-code-review

Automate pre-commit verification with static scans, tests, linting, and reviewer gates.

Community
Advanced
tranhieutttranhieutt
70

deployment-engineer

Automate secure CI/CD pipelines with GitOps and progressive delivery.

Community
Advanced