ship-it · frappe — Claude Code skill: what it does, how to install
This Claude Code skill takes finished changes through review and PR preparation. Run /ship-it to start, or resume work on a branch that already has an open PR.
no license 328 installs ★ 177 updated 2026-10-24
npx skills add frappe/skills --skill ship-it -a claude-codeWhat ship-it does
The skill takes completed code through review and prepares a pull request for a human to merge. It checks intent and changes, runs tests, updates docs and lint, then opens or updates the PR and follows CI. The prod tier runs every stage, including the bot loop; wip skips tests and docs. A person always merges the PR.
Run it explicitly with /ship-it [wip|prod] ["intent"]. On a branch with an open PR, it finds the next unfinished step from the branch commits and PR details, without relying on a separate state file. Changes made after review get another review before the PR is published or the run is reported as done.
What it helps with
- prepare completed changes for a pull request
- review changes added after the last review
- resume unfinished work on a branch with an open PR
- bring CI to a passing state
Example prompts for the agent
- Run
/ship-it prodand prepare the finished changes for a PR. - Run
/ship-it wip "Add report export"for this branch. - Resume work on the open PR in this branch with
/ship-it.
How to install ship-it
1Skills CLI (Vercel)
npx skills add frappe/skills --skill ship-it -a claude-code2Manually: put the files in place
~/.claude/skills/ship-it/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ship-it/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill ship-it -a codex2Manually: put the files in place
.agents/skills/ship-it/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill ship-it -a cursor2Manually: put the files in place
.cursor/skills/ship-it/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install frappe/skills skills/ship-it2Manually: put the files in place
.github/skills/ship-it/SKILL.md1Skills CLI (Vercel)
npx skills add frappe/skills --skill ship-it -a gemini-cli2Platform CLI
gemini skills install https://github.com/frappe/skills --path skills/ship-itManually: put the files in place
.devin/skills/ship-it/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add frappe/skills --skill ship-it -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ship-it
How do I install ship-it in Claude Code?
Run npx skills add frappe/skills --skill ship-it -a claude-code. The skill file is at ~/.claude/skills/ship-it/SKILL.md.
What does ship-it do?
It takes finished changes through review, testing, docs and CI, then prepares a pull request for a person to merge. The wip tier skips tests and docs.
What does ship-it need to work?
It uses git for branches and commits, and gh for pull request operations. Installing it in Claude Code uses npx.
Similar skills
All skills for Code review and refactoring →ship-it by other authors comes first.