kata-checkpoint-read

Detects and reads workspace .checkpoint files to resume or discard session context.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-checkpoint-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-checkpoint-read
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-checkpoint-read
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-checkpoint-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you recover an agent session’s saved progress by reading a workspace .checkpoint file and turning its contents into actionable session context.

Core Features & Use Cases

  • Detect checkpoint presence and schema: Determines whether .checkpoint is missing, in the current schema, or in an older schema.
  • Summarize and confirm user intent: In current schema, presents a concise summary (or full content in full mode) and captures your decision to resume, discard, or ignore.
  • Apply context safely: Loads only the approved fields into session memory on resume, and avoids parsing unknown/old schema while warning you.
  • Read-only by design: Never modifies .checkpoint during this operation; it only marks for overwrite as part of the session decision.

Quick Start

Tell the AI to “resume my session from the workspace .checkpoint file if it is in the current schema, otherwise proceed without applying any checkpoint context.”

Frequently Asked Questions about kata-checkpoint-read

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

FAQPage Schema
How do I resume an AI agent session from a checkpoint file?

You can resume an agent session by instructing the AI to read the workspace .checkpoint file, which detects the schema and loads the approved context into memory after you confirm the decision to resume.

What happens if my session checkpoint file uses an old schema?

If a session checkpoint file uses an old or deprecated schema, the read operation avoids parsing it and warns you about the schema mismatch. It safely proceeds without applying any unrecognized checkpoint context to the current agent session.

Is it safe to read a workspace checkpoint file without modifying it?

Reading a workspace checkpoint file is completely safe because the operation is strictly read-only by design. It never modifies the .checkpoint file during the session resume operation, only marking it for overwrite later based on your explicit decision.

How do I capture a deterministic user decision when resuming a workflow?

To capture a deterministic user decision when resuming a workflow, the skill presents a summary or full content of the checkpoint context and requires you to explicitly choose to resume, discard, or ignore the saved session state before proceeding.

Can I view a summary of saved agent context before loading it into session memory?

Yes, you can view a summary of saved agent context before loading it. The skill detects the current checkpoint schema and presents a concise summary or full content in presentation mode, allowing you to verify the data before applying it to the session.