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

58 lines
2 KiB
Markdown

---
title: "/cs-handoff-setup — Slash Command for AI Coding Agents"
description: "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
<div class="page-meta" markdown>
<span class="meta-badge">:material-console: Slash Command</span>
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/2-claude-skills/tree/main/productivity/handoff/commands/cs-handoff-setup.md">Source</a></span>
</div>
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:
```bash
rm ~/.config/handoff/config.json
rm ~/.config/handoff/.setup-declined 2>/dev/null
```
## Run
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py
```
For project-scoped overrides:
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py --reconfigure --project
```