Skip to content

alirezarezvani/claude-skills / productivity/handoff/skills/session-handoff

session-handoff

Verified

Write a handoff document so a fresh session or another agent can pick up exactly where this one left off: goal, current state, decisions, next steps and the skills to load, referencing existing files instead of copying them, with secrets redacted before saving. Use whenever the user is ending a session, switching machines, running low on context, or asks for a handoff, a handoff doc, a 'pick up where we left off' summary, or to compact the conversation for next time. Saves to a location the user picks on first run (OS temp, home folder or per-project .handoff/) and can auto-load the latest handoff at the next session start.

# handoff (skill)

Productivity-shaped handoff skill. Compact the current conversation into a handoff document for another agent to pick up.

See [SKILL.md](SKILL.md) for the workflow and [../../README.md](../../README.md) for the plugin-level overview.

## Quick start

```bash
# First-run setup (asks where to save handoffs)
python3 scripts/setup.py

# Generate a handoff scaffold for the next session
python3 scripts/handoff_template_generator.py --goal "your next-session goal"

# Lint the draft for secrets and PII before saving
python3 scripts/redaction_linter.py /path/to/draft.md
```

## What's in this folder

- `SKILL.md` — the skill prompt + invocation triggers + 5-section template.
- `scripts/` — 6 stdlib Python tools (setup, template generator, linter, recommender, cleanup, config loader).
- `references/` — 5 reference docs: mandatory checklist, structure, dedup discipline, redaction checklist, config reference.
- `assets/` — example handoff output.

## Inspired by

[Matt Pocock's handoff skill](https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff) (MIT). The seven-sentence body of `SKILL.md` is Matt's, preserved verbatim. The wrapper is this repo's.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall