AI Agent Skill HUB

handoff

Save session state to .rulebook/handoff/_pending.md for cross-session continuity

11 stars
byhivellm
View on GitHubInstallation ↓

Best use case

handoff is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Save session state to .rulebook/handoff/_pending.md for cross-session continuity

Teams using handoff should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/handoff/SKILL.md --create-dirs "https://raw.githubusercontent.com/hivellm/rulebook/main/.claude/skills/handoff/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/handoff/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How handoff Compares

Feature / AgenthandoffStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Save session state to .rulebook/handoff/_pending.md for cross-session continuity

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

Save a session handoff to `.rulebook/handoff/_pending.md`.

The handoff file MUST contain:

1. **Active task**: current task ID + phase + which checklist items are done
2. **Decisions made this session**: architectural choices, trade-offs, rejected alternatives
3. **Files touched**: list of files modified with one-line reason each
4. **Next steps**: concrete, actionable items (not vague "continue working")
5. **Exact resume command**: what to tell the next session to do first
6. **Open questions / blockers**: anything unresolved that needs the user's input

Write the file to `.rulebook/handoff/_pending.md` using the Write tool.

After writing successfully, display this message prominently:

>>> TYPE /clear NOW — your context will be auto-restored in the next session <<<

If the file `.rulebook/handoff/.urgent` exists, skip any confirmations and write immediately.

The SessionStart hook (`resume-from-handoff.sh`) will automatically inject the handoff content into the next session and archive the file.

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.