handoff-installlisted
Install: claude install-skill TySnyder/claude-handoff
# Handoff Install
One-step installer for the [claude-handoff protocol](https://github.com/TySnyder/claude-handoff) — a
director + archive pattern that keeps an AI coding agent oriented across sessions. This
file is self-contained: every template it writes is embedded below, so it works even
if the source repo was never cloned. See that repo's `docs/PROTOCOL.md` for the full
rationale — this skill only *installs* the protocol, it doesn't re-derive it from
scratch each run.
## What to do
### 1. Determine the project root
Use the given argument path if one was passed, otherwise the current working
directory. If unclear, resolve with `git rev-parse --show-toplevel`.
### 2. Check what's already installed — never clobber silently
- If `HANDOFF.md` already exists at the root: stop and tell the user it looks
already installed. Ask whether to leave it alone (default) or replace it.
- If `CLAUDE.md` already contains a `## CONTEXT / HANDOFF PROTOCOL` heading: the
block is already present — skip step 6, don't insert a duplicate.
- If `.claude/settings.json` already has a `hooks.Stop` entry running
`check-handoff-staleness.sh`: the hook is already installed — skip that part of
step 8.
This makes the skill safe to re-run on a project that's already partially set up.
### 3. Gather real values — don't leave placeholders behind
- `PROJECT_NAME`: prefer `package.json`'s `"name"`, else the git remote's repo name,
else the root directory's basename.
- `DATE`: today, via `date