adaptationio/checkpoint-manager
.claude/skills/checkpoint-manager/SKILL.md
State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation.
$ install --global
skillsauthnpx skillsauth add adaptationio/skrillz checkpoint-managerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 11:50 PM55.4s5 files scanned
SKILL.md
- name:
- checkpoint-manager
- description:
- State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation.
- version:
- 1.0.0
- category:
- autonomous-coding
- layer:
- verification-recovery
Checkpoint Manager
Creates and manages state checkpoints for safe rollback during autonomous coding.
Quick Start
Create Checkpoint
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
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
{
"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 guidereferences/ROLLBACK-PROCEDURES.md- Rollback details
Scripts
scripts/checkpoint_manager.py- Core managerscripts/git_snapshot.py- Git state capturescripts/state_snapshot.py- Feature/progress capturescripts/rollback_handler.py- Rollback execution
Related Skills
adaptationio/ttyd-remote-terminal-wsl2
development
VerifiedTrustedCommunity
Setup secure web-based terminal access to WSL2 from mobile/tablet via ttyd + ngrok/Cloudflare/Tailscale. One-command install, start, stop, status. Use when you need remote terminal access, web terminal, browser-based shell, or mobile access to WSL2 environment.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/tri-ai-collaboration
development
VerifiedTrustedCommunity
Complete development workflows where Claude writes the code while Gemini and Codex provide research, planning, reviews, and different perspectives. Claude remains the main developer. Use for complex projects requiring expert planning and multi-perspective reviews.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/todo-management
development
VerifiedTrustedCommunity
Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.
6SKILL.mdUpdated Mar 28, 2026
adaptationio/testing-workflow
testing
VerifiedTrustedCommunity
Comprehensive testing workflow orchestrating functional testing, example validation, integration testing, and usability assessment. Sequential workflow for complete skill testing from examples through scenarios to integration validation. Use when conducting thorough testing, pre-deployment validation, ensuring skill functionality, or comprehensive quality checks.
6SKILL.mdUpdated Mar 28, 2026