session-continuation

Manage workflow state across sessions with handoff and resume. TOON-based state persistence.

14 stars

Best use case

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

Manage workflow state across sessions with handoff and resume. TOON-based state persistence.

Teams using session-continuation 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/session-continuation/SKILL.md --create-dirs "https://raw.githubusercontent.com/nguyenthienthanh/aura-frog/main/aura-frog/skills/session-continuation/SKILL.md"

Manual Installation

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

How session-continuation Compares

Feature / Agent	session-continuation	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Manage workflow state across sessions with handoff and resume. TOON-based state persistence.

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

> **AI-consumed reference.** Optimized for Claude to read during execution.
> Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md)
> or [docs/getting-started/](../../../docs/getting-started/) depending on topic.


# Session Continuation

Manage workflow state across sessions.

## Triggers

Token ≥75% → suggest handoff. User says handoff/save → execute. User says resume + ID → load.

## Handoff Flow

1. Save to `.claude/logs/runs/[id]/run-state.json`: workflow_id, status, current_phase, agents, phases_completed (with deliverables), key decisions, token_usage
2. Output: workflow ID, phase progress, deliverables, resume command

## Resume Flow

1. Load state file → validate exists/valid
2. Restore: project context, agents, phase rules, decisions
3. Show summary → continue from saved phase

## Auto-Save

Phase completion, every 5 min, token milestones (100K/150K/175K). Silent except warning thresholds.

## TOON State Format (~160 tokens vs JSON ~600)

```toon
workflow:
  id: AUTH-1234
  phase: 3
  status: in_progress
agents[2]: architect,tester
```

## Error Handling

Not found → show available, suggest `/run`. Corrupted → restore from `.backup.json`.

## Cleanup

Completed: 30 days. Cancelled: 7 days. Paused: indefinitely.

Related Skills

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