handofflisted
Install: claude install-skill darkroomengineering/cc-settings
# Session Handoff
Two-mode skill: **Save** state at end of session, **Resume** state at start of next session.
## Mode: Save
Save current session state for later resumption. This is the **end-of-session boundary** skill — for mid-task rollback points before risky operations, use `/checkpoint`.
### Usage
```bash
bun ~/.claude/src/scripts/handoff.ts create
```
Or use the native command:
```
/handoff
```
### What Gets Saved
The handoff file includes:
- **Current task**: What you're working on
- **Progress**: What's been completed
- **Decisions made**: Key choices and rationale
- **Files modified**: List of changed files
- **Next steps**: What remains to be done
- **Context**: Important information to remember
- **Learnings**: Patterns discovered in session
### GitHub Issue Sync
If the current branch is linked to a GitHub Issue (e.g., `feat/123-description`):
1. **Post a progress comment** on the issue:
```bash
gh issue comment 123 --body "## Session Update
- Completed: [summary of work done]
- Files modified: [list]
- Next steps: [what remains]"
```
2. **Check off completed tasks** in the issue body if any task checkboxes were resolved during this session.
This ensures project progress is visible to the whole team, not just in local handoff files.
### Handoff Location
```
~/.claude/handoffs/
├── project-name-2024-01-15-1430.md
├── project-name-2024-01-14-0900.md
└── ...
```
### When to Create Handoff
1. **End of work session** - Before closing