ship

Installation
SKILL.md

Ship the current changes as a merged PR.

Read shared/git.md first.

Step 0 inspects the repo and prints an execution plan that marks each downstream step as RUN or SKIP. Follow that plan exactly — do not run a SKIP step, do not invent new ones. If any step exhausts its retry budget, stop and ask the user.

Step classification

Step Runs when
0. Preflight Always.
1. Branch off base Current branch == base branch AND something is shippable — an uncommitted change, or a commit origin/<base> does not have.
2. Test & lint A test or lint command is detected AND --no-test was not passed.
3. Commit git status --porcelain is non-empty. Its first sub-step moves the version, but only when 0h found a bumper AND --bump was passed.
4. PR The branch carries at least one commit the base does not, or an open PR already exists.
5. CI The PR reports at least one check, or the repository declares a workflow that would.
6. Merge Always (unless --draft — stop after step 4).
7. Worktree cleanup A git worktree holds the branch just shipped. It is removed only when this run is not standing in it.
Installs
2
Repository
misoto22/skills
First Seen
Aug 6, 2026