---

name: cs-handoff-setup description: "First-run setup for the handoff skill. Walks 5 questions (save location, retention, redaction strictness, git context, recommender scope) and writes the config. Run any time to reconfigure." argument-hint: "[--project to set project-specific overrides]" allowed-tools: ["Bash"]

/cs:handoff-setup

Configure the handoff skill. Walks 5 questions (plus 1-2 optional) and writes the config. Re-run any time.

Invocation

/cs:handoff-setup                 # configure global defaults
/cs:handoff-setup --project       # set project-specific overrides

Questions

1. Save location — OS temp / home folder / hidden home folder / per-project / custom. No pre-selected default — explicit choice required on first run.
2. Retention window — 7 / 30 days / forever / manual.
3. Redaction strictness — strict / warn / off.
4. Git context — auto-include branch + last commit + dirty file count? yes/no.
5. Skill recommendation scope — all repo / current domain only / off.
6. Filename style (only if save location ≠ temp) — date_slug / timestamp / mktemp.

Behaviour

• Global config at ~/.config/handoff/config.json.
• Project override at <repo>/.handoff/config.json (with --project). Missing keys fall back to global.
• For save_location.mode = project, setup offers to append .handoff/ to .gitignore.
• Idempotent. Re-running pre-fills current values.

Reset to defaults

Delete the config and rerun:

rm ~/.config/handoff/config.json
rm ~/.config/handoff/.setup-declined 2>/dev/null

Run

python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py

For project-scoped overrides:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py --reconfigure --project