task-persist

Persist and restore task progress across sessions via .context/task-state.json.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill task-persist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-persist
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/task-persist
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill task-persist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a mechanism to save and restore task progress across sessions by persisting state to a dedicated file, ensuring multi-step tasks can resume after context resets or session boundaries.

Core Features & Use Cases

  • Persist task state to .context/task-state.json to enable resuming work after interruptions.
  • Validate the task dependency graph before saving to catch cycles or orphaned references.
  • Restore pending and in-progress tasks with their relationships to continue work in subsequent sessions.

Quick Start

Call the skill with the save argument to persist the current tasks, or with load to restore the saved state.

Frequently Asked Questions about task-persist

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

FAQPage Schema
How do I save and restore task progress across session resets?

The skill validates the task dependency graph before saving to .context/task-state.json, catching cycles and orphaned references so that restored tasks maintain correct execution order without broken links.

Can I resume multi-step tasks after a context window compact operation?

When pixl is available, task state can optionally be persisted to the database instead of just the local file, providing an additional storage layer for restoring multi-step task progress across sessions.

How do I recreate tasks with their dependency graph intact after an interruption?

The skill uses TaskList, TaskGet, and TaskCreate to save existing tasks and recreate them during restoration, ensuring pending and in-progress tasks are rebuilt with their original dependency relationships preserved.

What happens if my task dependency graph has cycles before I save the session state?

The skill validates the dependency graph before saving to .context/task-state.json, catching cycles or orphaned references so that restored tasks maintain correct execution order without broken links.