← Back to Skills Marketplace
hollis9087

Long Task Handoff

by hollis9087 · GitHub ↗ · v0.3.3 · MIT-0
cross-platform ✓ Security Clean
49
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install long-task-handoff
Description
Automatically create a compact, standardized handoff file for long tasks to enable seamless session restarts or agent transfers without losing context or pro...
README (SKILL.md)

Long Task Handoff

Keep this skill lightweight. Do not manually reproduce the full handoff template in context. Use the bundled Python manager and keep user-facing messages short.

Detailed protocol is deferred to references/protocol.md. Do not load it during normal operation. Load it only if the manager is unavailable, the skill is being audited or modified, or a manual fallback is required.

Use The Manager

Prefer:

python scripts/handoff_manager.py update --workspace . --task "Task name" --event context_compaction --compaction-count N

Installed script paths:

  • Codex: .codex/skills/long-task-handoff/scripts/handoff_manager.py
  • Hermes: /root/.hermes/skills/software-development/long-task-handoff/scripts/handoff_manager.py

Useful commands:

python scripts/handoff_manager.py create --workspace . --task "Task name"
python scripts/handoff_manager.py update --workspace . --task "Task name" --event context_compaction --compaction-count N
python scripts/handoff_manager.py recover --workspace .
python scripts/handoff_manager.py suggest --compaction-count N --json
python scripts/handoff_manager.py validate handoffs/session-handoff-*.md

Pass rich task facts with --input-json when available. Otherwise pass only concise CLI facts such as --completed, --test-result, --key-file, --unfinished, --next-action, --risk, and --do-not-do.

Automatic Behavior

  • First compaction: update handoff quietly.
  • Second compaction: update handoff and verify handoffs/ACTIVE.md.
  • Third compaction: update handoff and briefly say restart is advisable.
  • Fourth compaction or state loss: update handoff and strongly recommend restart.
  • Fresh session with "continue", "keep going", "继续", or "接着做": run recover before asking the user for context.

The user should not need to know the handoff path. A new session prompt like "continue this task" should be enough when ACTIVE.md exists.

Boundaries

The handoff is a restart packet, not a project wiki. Include only current restart-critical state: goal, branch/commit/worktree, delta, tests, key files, unfinished items, next actions, risks, and do-not-do items.

Do not include secrets, .env contents, private keys, long chat logs, stale plans, unverified guesses as facts, or descriptions that conflict with the current workspace. Put durable project knowledge in repo docs and reference it by path.

If Script Fails

Do not silently continue. Report the concrete failure, keep the message short, and avoid asking the user to restate context unless recover cannot find or read a handoff.

Usage Guidance
Install this if you want automatic restart handoffs for long coding sessions. Review or delete `handoffs/ACTIVE.md` and old handoff files when switching tasks or sharing a workspace, and do not pass secrets into handoff payloads.
Capability Tags
cryptorequires-walletrequires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The capability matches the stated purpose: create, update, validate, and recover concise long-task handoff files. The bundled scripts write `handoffs/session-handoff-*.md` and `handoffs/ACTIVE.md`, inspect limited git state, and validate that handoffs avoid secrets.
ℹ Instruction Scope
The activation language is broad around compaction, resume, and continuation phrases, but the artifacts frame this as after restart or context-loss scenarios and require finding a handoff before recovery. Users should know the skill may act automatically in long-running sessions.
✓ Install Mechanism
The artifact contains Markdown, JSON evals, and dependency-free Python scripts. Metadata and static scan report no package dependencies or suspicious static findings; VirusTotal telemetry is absent.
✓ Credentials
Workspace write access and Python are proportionate for a local handoff manager. The script confines normal writes to a `handoffs` directory under the chosen workspace and does not perform network calls.
ℹ Persistence & Privilege
The skill intentionally persists restart state in workspace files and updates `ACTIVE.md`. This persistence is disclosed and purpose-aligned, but users should avoid installing it in workspaces where handoff notes should not be retained.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install long-task-handoff
  3. After installation, invoke the skill by name or use /long-task-handoff
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.3
Preserve full capability with progressive disclosure: keep SKILL.md lightweight while moving detailed protocol guidance to references/protocol.md for on-demand loading.
v0.3.2
Make skill body ultra-light for low context overhead; keep deterministic behavior in bundled Python manager.
v0.3.1
Clean packaging after CLI-first refactor: exclude local install metadata while preserving handoff_manager.py and slim SKILL.md.
v0.3.0
CLI-first refactor: add handoff_manager.py for create/update/find/recover/suggest/validate, slim SKILL.md to trigger protocol, and keep check_handoff.py as compatibility validator.
v0.2.1
Add compaction update discipline: active handoff is a current snapshot plus concise delta, stale content is removed, and Supersedes/Authoritative metadata prevents conflicting handoffs.
v0.2.0
Add low-friction automation contract: auto-update handoff on compaction, recommend restart after repeated compactions, and recover from vague continuation requests by reading ACTIVE.md.
v0.1.1
Metadata republish: corrected tag parsing after initial upload; no skill content changes.
v0.1.0
Initial release: proactive long-task handoff generation with validator, ACTIVE pointer, and cross-agent restart instructions.
Metadata
Slug long-task-handoff
Version 0.3.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 8
Frequently Asked Questions

What is Long Task Handoff?

Automatically create a compact, standardized handoff file for long tasks to enable seamless session restarts or agent transfers without losing context or pro... It is an AI Agent Skill for Claude Code / OpenClaw, with 49 downloads so far.

How do I install Long Task Handoff?

Run "/install long-task-handoff" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Long Task Handoff free?

Yes, Long Task Handoff is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Long Task Handoff support?

Long Task Handoff is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Long Task Handoff?

It is built and maintained by hollis9087 (@hollis9087); the current version is v0.3.3.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments