ship · saksham10arora-dotcom — Claude Code skill: what it does and how to install
ship is a Claude Code skill that commits repository changes, pushes the branch, and reports the commit details. It runs on /ship, requests to commit and push, or the end of a work session in a repo.
MIT ★ 101 updated 2026-11-11
npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a claude-codeWhat ship does
ship checks git status --short first. If the working tree is clean, it reports that there is nothing to send, includes the latest commit hash, and stops. An argument selects a project repository; without one, the target is the vault named by $ECX_VAULT.
For code repositories, the skill switches to or creates a working branch before committing; it never commits to main or master. It groups changes into topic-based commits, pushes the current branch, then reports each commit hash and message. If the push fails, the report shows the actual error.
What it helps with
- commit repository changes
- group work into topic-based commits
- push the current branch
- report pushed commit hashes and messages
Example prompts for the agent
- Run
/shipfor the current repository. - Commit the changes and push the branch.
- Check whether the changes are committed, then push them.
How to install ship
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a claude-code2Manually: put the files in place
~/.claude/skills/ship/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ship/
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a codex2Manually: put the files in place
.agents/skills/ship/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a cursor2Manually: put the files in place
.cursor/skills/ship/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install saksham10arora-dotcom/everything-claude-codex skills/ship2Manually: put the files in place
.github/skills/ship/SKILL.md1Skills CLI (Vercel)
npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a gemini-cli2Platform CLI
gemini skills install https://github.com/saksham10arora-dotcom/everything-claude-codex --path skills/shipManually: put the files in place
.devin/skills/ship/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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
How do I install ship in Claude Code?
Run npx skills add saksham10arora-dotcom/everything-claude-codex --skill ship -a claude-code. The skill file is at ~/.claude/skills/ship/SKILL.md.
What does ship do?
It checks the repository, creates topic-based commits, and pushes the current branch. Its report includes commit hashes and messages.
Can ship commit directly to main or master?
For code repositories, it creates or switches to a working branch before committing. The vault may use its default branch.
Source text
SKILL.md · MIT
--- name: ship description: Use when the user says "/ship", "ship it", "commit and push", "is it committed", or at the end of a work chunk that touched a repo. Commits, pushes and reports proof in one pass. --- # /ship: commit, push, prove 1. Target: no argument means the vault (`$ECX_VAULT`); an argument names a project repo. 2. `git status --short`. If clean: "nothing to ship" plus the last commit hash, then stop. 3. Code repos: never commit to main/master. Create or switch to a feature branch first. (Your notes vault may commit to its default branch.) 4. Split into logical commits by topic (2 to 5 is typical). Conventional messages: `feat:`, `fix:`, `notes:`, `content:`. 5. Push the current branch. 6. Report proof in exactly this shape: ``` Shipped: <n> commits pushed to <branch> <hash> <message> <hash> <message> ``` If the push fails, show the real error. Never say shipped when it isn't.
© saksham10arora-dotcom · MIT · saksham10arora-dotcom/everything-claude-codex
Similar skills
All skills for Git and GitHub →ship by other authors comes first.