claude-skills/docs/commands/cs-handoff-setup.md
Claude a767b51078
docs(productivity/handoff): sync CLAUDE.md, mkdocs nav, generated pages
CLAUDE.md updates:
- Current Scope: 328 -> 329 skills, +1 productivity handoff
- New v2.7.5 Highlights section documenting the productivity/handoff
  skill (first-run setup, redaction linter, SessionStart + SessionEnd
  hooks, fidelity self-check, --refresh flag)
- Footer: Last Updated May 23, Version v2.7.5, Status 329 skills /
  14 domains / 60 marketplace plugins

mkdocs.yml:
- Add productivity/handoff nav entry under "Productivity" section

Regenerated docs pages (scripts/generate-docs.py):
- docs/skills/productivity/handoff.md (new)
- docs/skills/productivity/index.md (refreshed)
- docs/commands/cs-handoff-setup.md (new)
- docs/agents/index.md + docs/commands/index.md (refreshed counts)
- Plus engineering senior-{backend,frontend,fullstack} pages picked
  up from earlier merged work (commit 30ff797) that hadn't yet been
  regenerated

mkdocs build verified: 20.05s, no errors. Handoff page renders at
site/skills/productivity/handoff/index.html. Pre-existing warnings
on cs-aeo and grill-with-docs are unrelated to this commit.

https://claude.ai/code/session_01KLhHBAfEDXdQMeRe6G8sRa
2026-05-23 01:31:05 +00:00

2 KiB

title description
/cs-handoff-setup — Slash Command for AI Coding Agents First-run setup for the handoff skill. Walks 5 questions (save location, retention, redaction strictness, git context, recommender scope) and writes. Slash command for Claude Code, Codex CLI, Gemini CLI.

/cs-handoff-setup

:material-console: Slash Command :material-github: Source

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