About ship
ship is a skill that helps developers follow a repository's documented process for landing work. It checks the branch and project instructions, follows the required review, checks, and PR conventions, and explicitly does not merge or deploy.
Key features
- 01Check the current branch and commit scope
- 02Read repository release and review instructions
- 03Run checks and reviews per project workflow
- 04Create or update PRs with gh
- 05Report the PR and outstanding tasks
Use cases
- 01Prepare a change according to repository conventions
- 02Run required project checks before submission
- 03Create or update a code review PR
- 04Identify steps left for a person in the release process
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/shipin Claude Code to confirm it loaded.
Details
From the project READMEShip
Each project has its own written path for landing work: how it is reviewed, which checks run and when, who merges. This skill finds that path and follows it. It adds no gates of its own.
- Confirm the branch is not the default branch and holds only this work (
git status,git log --oneline origin/HEAD..HEAD). - Read the repo's
AGENTS.mdorCLAUDE.mdand any review, CI or PR skill it names, and follow that path exactly: its review skill, its check command run on the pushed commit, its PR conventions and who merges. - If the repo documents no path, run its documented lint and test commands for the changed code, use
simplifyon the diff, useadversarial-reviewfor auth, money, migrations or data boundaries, then open the PR. - Open or update the PR with
gh, body from a temp file. Never merge or deploy from this skill. - Report the PR URL and anything the repo's path left for a person to do.
Where this skill and a repo's instructions disagree, the repo wins.
Comments
Markdown supported