checkpoint

Create deterministic checkpoints before mutating operations with restore commands.

4|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/synaptiai/agent-capability-standard --skill checkpoint-synaptiai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpoint
Source: https://github.com/synaptiai/agent-capability-standard/tree/main/skills/checkpoint
Command: npx skills add https://github.com/synaptiai/agent-capability-standard --skill checkpoint-synaptiai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Execute checkpoint to create a restorable state marker before any mutating operation, enabling rollback and audit trails to prevent irreversible changes.

Core Features & Use Cases

  • Create deterministic checkpoints prior to edits, deployments, or any state-changing operation.
  • Document and expose restore commands for safe rollback and compliance auditing.
  • Support multiple checkpoint types (git_stash, file_backup, state_snapshot) to suit different environments.

Quick Start

Create a checkpoint for the given scope and reason before mutating actions.

Frequently Asked Questions about checkpoint

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

FAQPage Schema
How do I create a restorable checkpoint before mutating files or deployments?

You can create a restorable checkpoint before mutating files or deployments by executing a checkpoint command for the given scope and reason. This generates a deterministic state marker with a restore command and an audit trail stored under the .checkpoints directory.

What is the best way to rollback configuration changes if a deployment fails?

The best way to rollback configuration changes is to use a pre-generated restore command from your checkpoint. The checkpoint records the prior state and exposes the exact rollback command needed to safely revert the failed mutating operation.

Does this checkpointing approach support git stash for tracking state changes?

Yes, this checkpointing approach supports git stash for tracking state changes. It offers multiple checkpoint types including git_stash, file_backup, and state_snapshot to suit different software project environments and mutating operations.

How does an audit trail for state mutations work across software projects?

An audit trail for state mutations works by documenting each checkpoint and its corresponding restore command. These records are stored deterministically under the .checkpoints directory, enabling compliance auditing and safe rollback for any irreversible actions.

When should I use a file backup versus a state snapshot for rollback safety?

Use a file backup for direct file edits and a state snapshot for broader configuration or deployment changes. Both checkpoint types generate deterministic restore commands to ensure rollback safety before executing any irreversible mutating operations.