acm-handoff
npx machina-cli add skill elb-pr/claudikins-automatic-context-manager/acm-handoff --openclawContext Handoff
This skill loads handoff content from a previous session that reached the context threshold.
Instructions
When this skill is invoked:
- Check for structured state at
.claude/claudikins-acm/handoff-state.json - Read the handoff markdown at
.claude/claudikins-acm/handoff.md - Present both to understand what was being worked on
- Restore todos if active todos exist in the state
- Continue the work from where it was left off
File Locations
| File | Purpose |
|---|---|
.claude/claudikins-acm/handoff-state.json | Structured state (preferred) |
.claude/claudikins-acm/handoff.md | Human-readable summary |
Reading the State
The structured state JSON contains:
context.current_objective- What was being worked oncontext.active_todos- Pending/in-progress todos to restorecontext.key_files_modified- Recently changed filesgit.branch- Git branch at handoff timegit.modified_files- Uncommitted changes
After Reading
- Restore todos using TodoWrite if
active_todoshas entries - Summarise the previous session's state for the user
- Ask if they want to continue from where they left off
- Clean up the handoff files after successful restoration
Cleanup
After successfully restoring context, offer to clean up:
rm -f .claude/claudikins-acm/handoff-state.json
rm -f .claude/claudikins-acm/handoff.md
If No Handoff Exists
If neither file exists, inform the user:
- No handoff is currently active
- A handoff is created when context usage hits the threshold (default 60%)
- They can configure the threshold via /acm:config
Claudikins Automatic Context Manager To configure settings, use: /acm:config
Source
git clone https://github.com/elb-pr/claudikins-automatic-context-manager/blob/main/skills/acm-handoff/SKILL.mdView on GitHub Overview
ACM handoff lets you resume a session that hit the context threshold or when a handoff summary exists. It reads the handoff-state.json and handoff.md to restore context, todos, and continue seamlessly.
How This Skill Works
When invoked, the skill checks for structured state at .claude/claudikins-acm/handoff-state.json and the handoff markdown at .claude/claudikins-acm/handoff.md. It presents both to you, restores active todos with TodoWrite if they exist, and then continues the work from where you left off, with an optional cleanup of the handoff files after successful restoration.
When to Use It
- You want to resume a session that reached the context threshold.
- A handoff summary exists and you need to continue from it.
- There are active todos to restore and you don’t want to lose progress.
- You need to review the previous git state (branch and modified files) before continuing.
- You are ready to proceed after confirming restoration, with an option to clean up handoff files.
Quick Start
- Step 1: Check for .claude/claudikins-acm/handoff-state.json and handoff.md.
- Step 2: Load and review both files to understand context and todos.
- Step 3: Restore todos (if any) with TodoWrite and continue from the saved state; offer cleanup after success.
Best Practices
- Check for both handoff-state.json and handoff.md before starting restoration.
- Verify active_todos in the state and restore them using TodoWrite if present.
- Summarize the previous session for quick context before continuing.
- Ask for confirmation to continue from where you left off to avoid surprises.
- Offer and perform cleanup of .claude/claudikins-acm/handoff-state.json and handoff.md after successful restoration.
Example Use Cases
- A developer resumes coding after a session hits the context threshold, restoring the previous objective and todos.
- A data analyst continues an analysis task using the handoff summary and restored context.
- A project manager reconnects to a paused task, restoring pending actions and the git state.
- A teammate verifies modified files and the branch from the handoff to avoid conflicts.
- After review, the team confirms continuation and ACM cleans up handoff files automatically.
