ship

Automates version bump, commit, and push to git after every completed task.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/levori119/skyboard --skill ship-levori119
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship
Source: https://github.com/levori119/skyboard/tree/main/.claude/skills/ship
Command: npx skills add https://github.com/levori119/skyboard --skill ship-levori119

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the risk of forgetting to bump the app version, commit, and push finished work to git, which otherwise leaves the team without visibility, blocks Railway deployment, and shows users a stale version number on the login screen. ## Core Features & Use Cases - Mandatory version bump first: Runs npm run version:bump before every commit so src/version.ts (APP_VERSION + date) always matches the shipped code. - Safe shared-tree workflow: Verifies the working tree belongs to you, uses targeted git add instead of git add -A, and rebases on origin/main before pushing from a worktree. - Three-layer enforcement: The skill flow, a PreToolUse hook reminder, and a git pre-push hook that blocks pushes to main without a bump. - Use Case: After finishing a bug fix with green type-checks and tests, the skill bumps the patch version, commits the changed files plus src/version.ts with a Hebrew conventional-commit message, rebases on origin/main, pushes, and reports the branch and version shipped. ## Quick Start Tell the assistant to commit and push the completed work, and it will run the version bump, commit your files, and push to git automatically.

Frequently Asked Questions about ship

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate version bumping before every git commit?

Run npm run version:bump before git add so src/version.ts is updated with the new APP_VERSION and timestamp, then include version.ts in the same commit. A pre-push hook blocks pushes to main that skip the bump.

How to push to main safely from a git worktree with multiple agents?

Fetch origin, rebase on origin/main, then push HEAD:main. If the rebase pulled in another agent's version bump, run version:bump again so your version stays above main, and commit it before pushing.

Why did my git push to main get rejected by the pre-push hook?

The pre-push hook detects a push to main without a version bump, creates a chore(version) commit, and intentionally stops the push because git fixes the SHA before the hook runs. Simply run the push command again to succeed.

Can I skip the automatic version bump for a local commit?

Yes, only when the user explicitly says no bump, or for a local-only commit on a feature branch that is never pushed. For a one-time push override, use SKIP_VERSION_BUMP=1 git push to bypass both hook layers.

What should I do when the working tree contains files from another agent?

Do not commit or clean up files that are not yours; that indicates another agent is working in the tree. Report the situation to the user and stop, using targeted git add for only your own files.