Agent skill
session-handoff
Generate a structured handoff document capturing current progress, open tasks, key decisions, and context needed to resume work. Use when ending a session, saying "continue later", "save progress", "session summary", or "pick up where I left off".
Install this agent skill to your Project
npx add-skill https://github.com/rohitg00/pro-workflow/tree/main/skills/session-handoff
SKILL.md
Session Handoff
Different from wrap-up. Wrap-up is a checklist for you. Handoff is a document written for the next session.
Trigger
Use when saying "handoff", "continue later", "pass to next session", "session transfer", or ending a session and wanting to resume smoothly.
Workflow
- Gather current state from git.
- List completed, in-progress, and pending work.
- Note key decisions made and their reasoning.
- Capture any learnings from this session.
- Generate a resume command for the next session.
Commands
git status
git diff --stat
git log --oneline -5
git branch --show-current
Output
# Session Handoff — [date] [time]
## Status
- **Branch**: feature/xyz
- **Commits this session**: 3
- **Uncommitted changes**: 2 files modified
- **Tests**: passing / failing / not run
## What's Done
- [completed task 1]
- [completed task 2]
## What's In Progress
- [current task with context on where you stopped]
- [file:line that needs attention next]
## What's Pending
- [next task that hasn't been started]
- [blocked items with reason]
## Key Decisions Made
- [decision 1 and why]
- [decision 2 and why]
## Learnings Captured
- [Category] Rule (from this session)
## Files Touched
- `path/to/file1.ts` — [what changed]
- `path/to/file2.ts` — [what changed]
## Gotchas for Next Session
- [thing that tripped you up]
- [non-obvious behavior discovered]
## Resume Command
> Continue working on [branch]. [1-2 sentence context]. Next step: [specific action].
Guardrails
- Write for the reader (next session), not the writer.
- Include specific file paths and line numbers where relevant.
- The resume command should be copy-pasteable into the next session.
- Keep it factual — describe changes functionally, don't infer motivation.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
auto-setup
Auto-configure quality gates, hooks, and settings for a new project. Detects project type and sets up appropriate tooling. Use when onboarding a new codebase.
agent-teams
Coordinate multiple Claude Code sessions as a team — lead + teammates with shared task lists, mailbox messaging, and file-lock claiming. Patterns for team sizing, task decomposition, and when to use teams vs sub-agents vs worktrees.
permission-tuner
Analyze permission denial patterns and generate optimized alwaysAllow and alwaysDeny rules. Use when permission prompts are slowing you down or after sessions with many denials.
wrap-up
End-of-session ritual that audits changes, runs quality checks, captures learnings, and produces a session summary. Use when saying "wrap up", "done for the day", "finish coding", or ending a coding session.
file-watcher
Configure file watching hooks to auto-react to config changes, env file updates, and dependency modifications. Use to set up reactive workflows.
compact-guard
Smart context compaction with state preservation. Saves critical files, task progress, and working state before compaction, restores after. Use before manual compact or when auto-compact triggers.
Didn't find tool you were looking for?