AI Skills Catalog
AI Workers

Session Handoff

Create a compact handoff that lets another agent resume the work.
SKILL SCORE83How it is scored
VerifiedFreeMIT

Works with

Packaged from the source skill for Claude, Codex and 4 more.

What Session Handoff does

Create a compact handoff that lets another agent resume the work. Use it when working with a development session with decisions and unfinished tasks.

Task stages

  1. Invocation Triggers
  2. First-Run Setup
  3. Section Template

Expected deliverable: temporary handoff document linking existing artifacts.

Limitations

Sensitive information must be redacted and referenced files must remain accessible.

What is inside the skill

Section headings from the original SKILL.md (about 1,223 words of instructions). Read the full text in the source repository before installing.

  1. Invocation Triggers
  2. First-Run Setup
  3. Output Path
  4. Section Template
  5. The Agent's Job
  6. Anti-Patterns
  7. Redaction
  8. SessionStart Auto-Load
  9. SessionEnd Reminder
  10. Refreshing an Existing Handoff
  11. Tools
  12. Slash Commands
  13. Agent
  14. Examples
  15. Example 1 — explicit invocation with a goal
  16. Example 2 — implicit trigger
  17. Example 3 — first-run setup
  18. Example 4 — SessionStart auto-load
  19. Usage

Bundled files

  • README.md
  • assets/example_handoff.md
  • references/configuration.md
  • references/deduplication_discipline.md
  • references/handoff_prompt.md
  • references/handoff_structure.md
  • references/redaction_checklist.md
  • scripts/cleanup.py
  • scripts/config_loader.py
  • scripts/handoff_self_check.py
  • scripts/handoff_template_generator.py
  • scripts/redaction_linter.py
  • scripts/setup.py
  • scripts/skill_recommender.py
  • LICENSE

Example prompts

  • Use Session Handoff with a development session with decisions and unfinished tasks; produce temporary handoff document linking existing artifacts.
  • For Session Handoff, focus on Invocation Triggers: explain the evidence needed, unresolved assumptions and next practical action.

How to install Session Handoff

Claude Packaged
  1. Download the Claude package from the skill page. The ZIP contains one folder named after the skill, with SKILL.md and any bundled reference files.
  2. For Claude Code, unpack the folder into ~/.claude/skills/ to use it in every project, or into .claude/skills/ inside a repository to share it with your team.
  3. For Claude apps, upload the ZIP in the Skills section of the capabilities settings.
  4. Start a new session and describe the task in your own words. Claude picks the skill when the request matches its description.
More about skills for Claude
Codex Packaged
  1. Download the Codex package. The ZIP contains one folder named after the skill, with SKILL.md and bundled resources.
  2. Unpack the complete folder into .agents/skills/ inside your repository, or into ~/.agents/skills/ for personal use. Preserve its relative reference-file paths.
  3. Start a new Codex session and invoke the skill by name or with $skill-name, or describe a matching task.
  4. AGENTS.md is separate project guidance. The ZIP does not generate or modify that file.
More about skills for Codex
GPT Packaged
  1. Download the GPT package from the skill page.
  2. Create or edit a custom GPT (or a ChatGPT project) and paste the contents of SKILL.md into the instructions field.
  3. Upload the bundled reference files as knowledge so the GPT can consult them.
  4. Test with one of the example prompts from the skill page and adjust the instructions if your use case differs.
More about skills for GPT
Gemini Packaged
  1. Download the Gemini package from the skill page.
  2. For a project, unpack the complete folder into .gemini/skills/ or .agents/skills/. For personal use, use ~/.gemini/skills/ or ~/.agents/skills/.
  3. Run /skills reload in Gemini CLI, then /skills list to check discovery. There is no need to paste the skill into GEMINI.md.
  4. Test a matching task and verify the referenced tools and files are available.
More about skills for Gemini
Cursor Packaged
  1. Download the Cursor package from the skill page.
  2. Unpack the complete skill folder into .cursor/skills/ or .agents/skills/ in your project. For personal local use, ~/.cursor/skills/ and ~/.agents/skills/ are also supported.
  3. Start a new Cursor session. Type / in Agent chat and select the skill name, or describe a matching task.
  4. Commit the skill folder and resources for team use. Personal local skills are not automatically available to remote agents or automation runs.
More about skills for Cursor
OpenCode Packaged
  1. Download the OpenCode package from the skill page.
  2. Unpack the complete folder into .opencode/skills/ in your project, or ~/.config/opencode/skills/ for personal use. OpenCode also supports .agents/skills/ and .claude/skills/ compatibility locations.
  3. Keep supporting files at their original relative paths. AGENTS.md is separate project-wide guidance and is not generated by this ZIP.
  4. Start OpenCode in the project and test a matching task with the model and permissions you use.
More about skills for OpenCode

Permissions & security

Low risk

Inspect the source, license and declared permissions before use. Read the scripts before running them. Review method

Read project files
Write generated skill files

Session Handoff FAQ

What does the Session Handoff skill do?

Create a compact handoff that lets another agent resume the work.

Which AI agents can use Session Handoff?

Packages for Claude, Codex and 4 more are built from the same source instructions.

How do I install Session Handoff in Claude?

Download the Claude package from the skill page. The ZIP contains one folder named after the skill, with SKILL.md and any bundled reference files. For Claude Code, unpack the folder into ~/.claude/skills/ to use it in every project, or into .claude/skills/ inside a repository to share it with your team.

Who made Session Handoff and what is the license?

Session Handoff is published by Alireza Rezvani under the MIT license. The source is https://github.com/alirezarezvani/claude-skills/tree/main/productivity/handoff/skills/session-handoff. The catalog keeps the original attribution.

What permissions does Session Handoff need?

Declared permissions: read project files, write generated skill files. Risk level: low. Check the scripts in the source before running them.

Session Handoff Skill for Claude & Codex | AI Skills Catalog