Skip to content
Productivity
Skill

/ship

Commit and push the current work properly — lint, run the release gate, write a detailed commit message, push to GitHub. Use whenever work reaches a milestone or the user says ship it, commit, or push.

From plugin
waku-agent
2.2k14 skills

Claude Code

$ npx -y skills add ShenSeanChen/waku-agent --skill ship --agent claude-code

SKILL.md

ship.SKILL.md
name: ship
description: Commit and push the current work properly — lint, run the release gate, write a detailed commit message, push to GitHub. Use whenever work reaches a milestone or the user says ship it, commit, or push.

Procedure

1. `make lint` — fix anything it flags before continuing. 2. `make gate` — the release gate. Deterministic evals must pass 100%; judge evals must clear threshold when an API key is present. If the gate closes, fix the cause (or, if a finding is a genuine behavior change, update the eval WITH the user's agreement) — never push a red gate. 3. Review `git status` and `git diff` — confirm nothing unintended is staged (especially nothing from `.waku/` or `.env`). 4. Commit with a detailed message:

  • Subject: imperative, specific ("Fix triple-booking from first live test"),

never generic ("update code", "fixes").

  • Body: WHY the change exists, what evidence motivated it (live bug, trace,

eval failure), and what verification it survived.

  • End with: `Co-Authored-By: Claude <the current model's attribution line>`

5. **Push via a branch and a PR — `git push origin main` will be REJECTED.** Since 2026-07-26 `main` requires the `skills-and-evals` check to be green BEFORE a commit can land, and `enforce_admins` is on, so this applies to Sean and to Claude equally. There is no bypass and you should not look for one.

   git checkout -b <short-topic-branch>
   git push -u origin HEAD
   gh pr create --fill                    # body already written in step 4
   gh pr checks --watch                   # ~30s
   gh pr merge --squash --delete-branch   # ONLY Sean's own work, see below
   git checkout main && git pull -q

The rejection looks like `GH006: Protected branch update failed` — that is the guard working, not a broken setup. Don't retry with `--force`; force pushes to main are blocked too.

6. **A community PR is never merged here.** This procedure covers Sean's own work. Merging someone else's PR requires his explicit per-PR go-ahead — see the `review-pr` skill's hard rule.

7. If CI goes red after a merge, fix forward immediately — don't leave main red.

Why the extra steps

Eight commits landed on main in one session on 2026-07-26 while `enforce_admins` was off. Every push printed `Bypassed rule violations` and went through anyway; CI ran AFTER each one rather than gating it. All eight happened to be green, so nothing broke — but a red commit would have landed exactly the same way. CI takes ~30 seconds. The branch-and-PR round trip costs about a minute and makes a broken main impossible rather than unlikely.

Read more
@shenseanchen
Ships withwaku-agent

Your own AI assistant. On your laptop. In code you can read in an afternoon. Meet Waku — a local-first personal assistant that shows the four pillars behind every serious agent: Harness · Loop · Memory · Eval/LLM-Ops. No frameworks hiding the good parts.

Stars on GitHub

Momentum

stars in total
2.2k
Star history of ShenSeanChen/waku-agent on GitHub, a chart by star-history.com

Other skills on waku-agent.

excalidraw

excalidraw

Generate an Excalidraw whiteboard in Sean's hand-drawn video style (Excalifont, roughness 1, green signature, socials +…

new-tool

new-tool

Add a new tool to Waku the right way — schema, safe execution, deterministic eval, honest output. Use when adding or modifying…

pr-worktree

pr-worktree

Create and tear down the throwaway git worktrees used to test community PRs for waku-agent, without leaking API keys or leaving…

release

release

Cut a waku-agent release when main is ahead of the last tag. Check the gap, bump the version, tag, confirm PyPI, announce. Use…

review-pr

review-pr

Walk Sean through an incoming waku-agent PR or issue and present it his way — four fixed sections: what this is, why it matters,…

pokedex

pokedex

Look up any Pokemon's types, base stats, and abilities from the public PokeAPI. Use whenever the user mentions a specific Pokemon…

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about ship.

Which coding agents can use ship?
ship installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.