agent-restore-context

What problem does it solve?

When an AI session is cleared or compacted, important in-progress skill state and prompts are lost, interrupting long-running or multi-step agent workflows. This Skill provides a lightweight, file-based mechanism to persist a complete resume prompt so a skill can be reloaded and continue after a context reset.

Core Features & Use Cases

• Write restore context: Create or overwrite .agent-restore-context-<skill-name> files containing a self-contained resume prompt that tells the agent how to restore state and reload the full skill.
• Delete cleanup: Remove restore files when workflows are complete; operations are idempotent and safe to repeat.
• Check & setup validation: Inspect .claude/settings.json and optional settings.local.json for the restore-context SessionStart hook and offer to run setup if missing.
• Status & previews: List all active restore-context files and show filename-derived skill names with a short content preview to help manage active resumes.
• Use case: Save progress for long-running tasks like issue implementation or test runs so the agent can resume after a manual /clear or automatic compaction.

Quick Start

Run /agent-restore-context write jira-implement-task -- === RESUMED AFTER CONTEXT RESET === followed by the resume prompt content to save the restore context for the jira-implement-task skill.