🎯

checkpoint-manager

🎯Skill

from adaptationio/skrillz

What it does

checkpoint-manager skill from adaptationio/skrillz

📦

Part of

adaptationio/skrillz(191 items)

checkpoint-manager

Installation

Add MarketplaceAdd marketplace to Claude Code

/plugin marketplace add adaptationio/Skrillz

Install PluginInstall plugin from marketplace

/plugin install skrillz@adaptationio-Skrillz

Claude CodeAdd plugin in Claude Code

/plugin enable skrillz@adaptationio-Skrillz

Add MarketplaceAdd marketplace to Claude Code

/plugin marketplace add /path/to/skrillz

Install PluginInstall plugin from marketplace

/plugin install skrillz@local

+ 4 more commands

📖 Extracted from docs: adaptationio/skrillz

Need more details? View full documentation on GitHub →

1Installs

Last UpdatedJan 16, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation.

Overview

# Checkpoint Manager

Creates and manages state checkpoints for safe rollback during autonomous coding.

Quick Start

Create Checkpoint

```python

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir)

checkpoint = await manager.create_checkpoint(

name="before-refactor",

description="State before major refactoring"

)

```

Rollback to Checkpoint

```python

await manager.rollback(checkpoint.id)

# or rollback to latest

await manager.rollback_to_latest()

```

Checkpoint Workflow

```

┌─────────────────────────────────────────────────────────────┐

│ CHECKPOINT WORKFLOW │

├─────────────────────────────────────────────────────────────┤

│ │

│ CREATE CHECKPOINT │

│ ├─ Capture git state (commit hash, dirty files) │

│ ├─ Snapshot feature list │

│ ├─ Save progress file state │

│ ├─ Record context (session, tokens) │

│ └─ Store checkpoint metadata │

│ │

│ RISKY OPERATION │

│ ├─ Attempt operation │

│ ├─ If success → Continue │

│ └─ If failure → Rollback to checkpoint │

│ │

│ ROLLBACK │

│ ├─ Load checkpoint data │

│ ├─ Git reset to checkpoint commit │

│ ├─ Restore feature list │

│ ├─ Restore progress file │

│ └─ Clean up temporary files │

│ │

└─────────────────────────────────────────────────────────────┘

```

Checkpoint Structure

```json

{

"id": "checkpoint-20250115-103000",

"name": "before-refactor",

"description": "State before major refactoring",

"timestamp": "2025-01-15T10:30:00",

"git_state": {

"commit_hash": "abc1234",

"branch": "main",

"dirty_files": ["src/app.ts"]

"feature_state": {

"current": "auth-003",

"completed": ["auth-001", "auth-002"],

"snapshot_path": ".claude/checkpoints/checkpoint-xxx/feature_list.json"

"context": {

"session_number": 5,

"token_usage": 45000

}

```

Checkpoint Types

| Type | Trigger | Retention |

|------|---------|-----------|

| Automatic | Before risky operations | Last 5 |

| Manual | User/agent request | Until deleted |

| Feature | After feature complete | Permanent |

| Session | Start of session | Last 3 |

Integration Points

error-recoverer: Triggers rollback on failures
coding-agent: Creates checkpoints before changes
autonomous-loop: Manages checkpoint lifecycle
context-state-tracker: Provides state to checkpoint

References

references/CHECKPOINT-STRATEGY.md - Strategy guide
references/ROLLBACK-PROCEDURES.md - Rollback details

Scripts

scripts/checkpoint_manager.py - Core manager
scripts/git_snapshot.py - Git state capture
scripts/state_snapshot.py - Feature/progress capture
scripts/rollback_handler.py - Rollback execution

More from this repository10

🎯

xai-stock-sentiment🎯Skill

xai-stock-sentiment skill from adaptationio/skrillz

🎯

ralph-prompt-single-task🎯Skill

Generates Ralph-compatible prompts for single implementation tasks with clear completion criteria and automatic verification.

🎯

autonomous-loop🎯Skill

Orchestrates continuous autonomous coding sessions, managing feature implementation, testing, and progress tracking with intelligent checkpointing and recovery mechanisms.

🎯

auto-claude-troubleshooting🎯Skill

auto-claude-troubleshooting skill from adaptationio/skrillz

🎯

auto-claude-setup🎯Skill

auto-claude-setup skill from adaptationio/skrillz

🎯

observability-analyzer🎯Skill

Analyzes Claude Code observability data to generate insights on performance, costs, errors, tool usage, sessions, conversations, and subagents through advanced metrics and log querying.

🎯

xai-financial-integration🎯Skill

xai-financial-integration skill from adaptationio/skrillz

🎯

xai-agent-tools🎯Skill

xai-agent-tools skill from adaptationio/skrillz

🎯

xai-crypto-sentiment🎯Skill

xai-crypto-sentiment skill from adaptationio/skrillz

🎯

auto-claude-memory🎯Skill

auto-claude-memory skill from adaptationio/skrillz