Session State Skill

Save and load agent state files to resume work after interruptions.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/mdmagnuson-creator/helm-ade-toolkit --skill session-state-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Session State Skill
Source: https://github.com/mdmagnuson-creator/helm-ade-toolkit/tree/main/skills/session-state
Command: npx skills add https://github.com/mdmagnuson-creator/helm-ade-toolkit --skill session-state-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a standardized way for agents to manage their persistent state, including right-panel todos and current task tracking, ensuring seamless session resumption and recovery from interruptions like rate limits or context compaction.

Core Features & Use Cases

  • State Persistence: Saves and loads agent-specific state files for continuity.
  • Todo Management: Synchronizes tasks between the agent's state and the right-panel UI.
  • Rate Limit Handling: Gracefully detects and reports rate limiting, pausing execution until user input.
  • Compaction Recovery: Tracks the current task to allow resumption after context window resets.
  • Use Case: When an agent is building a complex feature, its progress, pending tasks, and the last action taken are saved. If the agent is interrupted by a rate limit, it can resume exactly where it left off once the limit is lifted, or a new session can pick up the work.

Quick Start

Use the session state skill to restore todos from the state file upon agent startup.

Frequently Asked Questions about Session State Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume agent tasks after a rate limit or context compaction interrupt?

To resume agent tasks after an interruption, session state persistence saves the current task and pending todos to a file, allowing the agent to reload its exact progress and continue execution seamlessly.

What is the best way to manage persistent todos across multiple agents?

Managing persistent todos across builder, planner, and toolkit agents requires synchronizing task lists to a shared state file, ensuring all agents track and update the same right-panel UI todos consistently.

How does session state tracking work when an agent context window is compacted?

Session state tracking works by recording the agent's last action and current task to a state file before compaction, enabling the agent to read the file and resume work exactly where it stopped.

Can I use state files to pause and resume complex feature development in agents?

Yes, you can use state files to pause and resume complex feature development by saving progress, pending tasks, and recent actions, which a new session or agent can load to continue the work.

Does session state management require dependencies to synchronize right-panel UI todos?

No dependencies are required to synchronize right-panel UI todos, as the session state skill independently manages state file saving and loading to keep task tracking consistent across agents.

Why does my agent lose its todo list after a context window reset?

An agent loses its todo list after a context window reset because in-memory state is cleared, but saving todos to a persistent state file before compaction allows full task recovery.