Use when the user says "onboard me", "set up hand", "what does hand do", "walk me through setup", or invokes /hand:onboard. Guides through installation, verification, and first use of the hand session handoff plugin.
hand provides three skills for structured project handoff across Claude Code sessions:
| Skill | When |
|---|---|
/hand:on | Session start — triage open items, act on P1s, surface human-edits |
/hand:off | Session end — update HANDOFF.yaml, write .ctx/, sync SQLite, commit |
/hand:over | On demand — generate visual report + Mermaid diagrams |
which claude sqlite3 handoff-detect
claude — Claude Code CLI (required)sqlite3 — local status DB (required; ships with macOS)handoff-detect — resolves HANDOFF.yaml for current repo (install from atelier tooling)If handoff-detect is missing, hand falls back to globbing HANDOFF.*.yaml at repo root.
git clone https://github.com/89jobrien/hand ~/dev/hand
cd ~/dev/hand
just init
just init will:
core.hooksPath = .githooks so the post-commit hook auto-reinstalls on source changesclaude plugin install hand@localIf just is not installed: brew install just.
If the local marketplace is not set up yet, install directly:
claude plugin install /path/to/hand
In a new Claude session, run /hand:on in any git repo. Expected output:
## Handoff Triage — <repo>
No HANDOFF file found. Run /hand:off at session end to create one.
Or, if a HANDOFF.yaml exists, it surfaces items by priority.
At the end of a session, run /hand:off. It will:
HANDOFF.<project>.<base>.yaml at repo root.ctx/HANDOFF.state.yaml (build/tests/branch)~/.local/share/atelier/handoff.dbHANDOFF.yamlRun /hand:over to generate .ctx/HANDOVER.md with Mermaid diagrams.
Requires uv and pyyaml for the diagram script (falls back to inline generation).
Run
/hand:onat every session start. Run/hand:offbefore closing. HANDOFF.yaml is committed;.ctx/is never committed.