How jumpifequal/handoff-skill works
Handoff is a portable Agent Skill for capturing session state in a structured Markdown artifact and resuming work in another AI session. The primary flow is conversational handoff creation, artifact transfer, intake, and continuation; optional Claude Code and Codex lifecycle hooks create degraded transcript-based fallback artifacts. The README documents domain-specific addenda and validation as additional capabilities. Sampled hook and validator source supports those internal edges; unsampled manual-skill behavior is represented only at the documented level.
Main entry points: claude_handoff_hook.js Claude fallback hook · codex_handoff_hook.js Codex fallback hook · validate_handoff.js Handoff validator · SKILL.md Handoff skill
Components 15
Manual handoff
- Handoff skill
SKILL.md - Domain addenda
references/domain-addenda.md - Usage examples
docs/examples.md
Artifact and intake
- Handoff artifact
- Receiving AI
- Intake guidance
docs/intake.md
Lifecycle automation
- Claude Code lifecycle
- Codex CLI lifecycle
- Claude hook installer
scripts/claude_install_hooks.js - Codex hook installer
scripts/codex_install_hooks.js - Claude fallback hook
scripts/claude_handoff_hook.js - Codex fallback hook
scripts/codex_handoff_hook.js - Session transcript
Validation
- Handoff validator
scripts/validate_handoff.js
Other components
- User
Connections 19
- User → Handoff skill: requests handoff
- Handoff skill → Domain addenda: adds relevant context
- Handoff skill → Handoff artifact: creates artifact
- User → Receiving AI: provides artifact
- Receiving AI → Intake guidance: follows intake
- Receiving AI → Handoff artifact: reads state
- Usage examples → User: demonstrates use
- Claude Code lifecycle → Claude fallback hook: triggers fallback
- Codex CLI lifecycle → Codex fallback hook: triggers fallback
- Session transcript → Claude fallback hook: supplies transcript
- Session transcript → Codex fallback hook: supplies transcript
- Claude fallback hook → Handoff artifact: writes raw dump
- Codex fallback hook → Handoff artifact: writes raw dump
- Claude fallback hook → Handoff validator: self-validates
- Codex fallback hook → Handoff validator: self-validates
- User → Handoff validator: checks artifact
- Claude hook installer → Claude fallback hook: installs hook
- Codex hook installer → Codex fallback hook: installs hook
- Handoff validator → Handoff artifact: checks structure