Use when work is done and you need to commit, push, close beads, and sync in one shot. The quick session-close ceremony.
Install
npx skillscat add mistakeknot/clavain/ship Install via the SkillsCat registry.
SKILL.md
Ship
One-shot session close: commit, push, close beads, sync. Use when verification is already done. For careful landing with verification, use landing-a-change instead.
Announce: "I'm using the ship skill to close out this work."
Inputs
- Bead IDs to close (ask if not provided)
- Commit message (draft from staged changes if not provided)
Step 1: Check State
git status && git diff --cached --stat- Unstaged changes → ask what to stage
- No changes and no beads to close → "Nothing to ship" and stop
Step 2: Commit
- Stage specific files (prefer over
git add -A) - Draft concise commit message or use provided one
git commit -m "..." -m "Co-Authored-By: Claude <noreply@anthropic.com>"
Step 3: Push
git pushIf push fails (diverged), stop and report — do not force push.
Step 4: Close Beads
for bead_id in <id1> <id2> ...; do
"${CLAUDE_PLUGIN_ROOT}/scripts/gates/bead-close.sh" "$bead_id" "Shipped after successful push"
doneIf no IDs provided, list in_progress beads for this session and ask which to close.
Step 5: Sync Beads
bash .beads/push.shStep 6: Final Push
git pushStep 7: Confirm
Report: commit hash + message, files changed, beads closed, push status.