How do I install the Rollback skill?

Run npx skillmds@latest add ww-w-ai/rollback in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Rollback safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rollback?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rollback free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rollback?

ww-w-ai (@ww-w-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rollback by ww-w-ai — Agent Skill

Name: Rollback
Author: ww-w-ai

Rollback

Manage checkpoints and rollback for safe recovery. Create restore points before risky operations and restore to previous states when needed. Use proactively when user mentions rollback, undo, restore, checkpoint, or recovery. Triggers: rollback, checkpoint, restore, undo, revert, recovery, save point, 롤백, 체크포인트, 복원, 되돌리기, 복구, ロールバック, チェックポイント, 復元, 元に戻す, 回滚, 检查点, 恢复, 撤销, restaurar, punto de control, revertir, deshacer, restaurer, point de contrôle, annuler, revenir, Wiederherstellung, Prüfpunkt, rückgängig machen, ripristino, checkpoint, annullare, ripristinare Do NOT use for: git operations (use git directly), file editing

ww-w-ai 49de132 3.6 KB Updated Sep 17, 2026

File contents

Rollback Skill

Create, list, and restore checkpoints for safe recovery

Commands

Command	Description	Example
`/rollback create`	Create a new checkpoint	`/rollback create "before refactor"`
`/rollback list`	List all checkpoints	`/rollback list`
`/rollback restore [id]`	Restore to a checkpoint	`/rollback restore chk-20260409-143000`
`/rollback diff [id]`	Show changes since checkpoint	`/rollback diff chk-20260409-143000`

MCP Integration

This skill uses the bkit_checkpoint MCP tool to manage checkpoints.

How to Execute

Create Checkpoint

Call bkit_checkpoint with action create
Optionally include a label for easy identification
The tool snapshots the current state of tracked files
Returns a checkpoint ID (format: chk-YYYYMMDD-HHMMSS)
Display confirmation with the checkpoint ID

List Checkpoints

Call bkit_checkpoint with action list
Display checkpoints in reverse chronological order
Show: ID, timestamp, label, file count, size

Restore Checkpoint

Call bkit_checkpoint with action restore and the checkpoint ID
Important: Automatically create a new checkpoint before restoring (safety net)
Restore files to the checkpoint state
Display list of files changed/restored
Warn about any files that were added after the checkpoint (they will remain)

Show Diff

Call bkit_checkpoint with action diff and the checkpoint ID
Compare current state against the checkpoint
Show added, modified, and deleted files
Display line-level diff for modified files

Checkpoint Storage

Checkpoints are stored in .bkit/checkpoints/:

.bkit/checkpoints/
  chk-20260409-143000/
    manifest.json    # List of files and their hashes
    label.txt        # Optional label
    files/           # Snapshot of tracked files

Manifest Format

{
  "id": "chk-20260409-143000",
  "timestamp": "2026-04-09T14:30:00Z",
  "label": "before refactor",
  "files": [
    {
      "path": "src/api/auth.js",
      "hash": "sha256:abc123...",
      "size": 2456
    }
  ],
  "totalFiles": 12,
  "totalSize": 34567
}

Auto-Checkpoint Triggers

Checkpoints are automatically created by hooks in these situations:

Before deployment (/deploy)
Before PDCA iterate phase
Before bulk file operations (10+ files)

Output Format

## Checkpoint Created

- **ID**: chk-20260409-143000
- **Label**: before refactor
- **Files**: 12 tracked files
- **Size**: 34.5 KB

Use `/rollback restore chk-20260409-143000` to restore.

Safety Rules

Always create backup before restoring (double safety net)
Never delete checkpoints automatically - user must manage
Warn on old checkpoints - flag if restoring to a checkpoint older than 24 hours
Show diff first - recommend /rollback diff before /rollback restore

---name: rollbackdescription: Manage checkpoints and rollback for safe recovery. Create restore points before risky operations and restore to previous states when needed. Use proactively when user mentions rollback, undo, restore, checkpoint, or recovery. Triggers: rollback, checkpoint, restore, undo, revert, recovery, save point, 롤백, 체크포인트, 복원, 되돌리기, 복구, ロールバック, チェックポイント, 復元, 元に戻す, 回滚, 检查点, 恢复, 撤销, restaurar, punto de control, revertir, deshacer, restaurer, point de contrôle, annuler, revenir, Wiederherstellung, Prüfpunkt, rückgängig machen, ripristino, checkpoint, annullare, ripristinare Do NOT use for: git operations (use git directly), file editing---# Rollback Skill> Create, list, and restore checkpoints for safe recovery## Commands| Command | Description | Example ||---------|-------------|---------|| `/rollback create` | Create a new checkpoint | `/rollback create "before refactor"` || `/rollback list` | List all checkpoints | `/rollback list` || `/rollback restore [id]` | Restore to a checkpoint | `/rollback restore chk-20260409-143000` || `/rollback diff [id]` | Show changes since checkpoint | `/rollback diff chk-20260409-143000` |## MCP IntegrationThis skill uses the `bkit_checkpoint` MCP tool to manage checkpoints.### How to Execute#### Create Checkpoint1. Call `bkit_checkpoint` with action `create`2. Optionally include a label for easy identification3. The tool snapshots the current state of tracked files4. Returns a checkpoint ID (format: `chk-YYYYMMDD-HHMMSS`)5. Display confirmation with the checkpoint ID#### List Checkpoints1. Call `bkit_checkpoint` with action `list`2. Display checkpoints in reverse chronological order3. Show: ID, timestamp, label, file count, size#### Restore Checkpoint1. Call `bkit_checkpoint` with action `restore` and the checkpoint ID2. **Important**: Automatically create a new checkpoint before restoring (safety net)3. Restore files to the checkpoint state4. Display list of files changed/restored5. Warn about any files that were added after the checkpoint (they will remain)#### Show Diff1. Call `bkit_checkpoint` with action `diff` and the checkpoint ID2. Compare current state against the checkpoint3. Show added, modified, and deleted files4. Display line-level diff for modified files## Checkpoint StorageCheckpoints are stored in `.bkit/checkpoints/`:```.bkit/checkpoints/ chk-20260409-143000/ manifest.json # List of files and their hashes label.txt # Optional label files/ # Snapshot of tracked files```### Manifest Format```json{ "id": "chk-20260409-143000", "timestamp": "2026-04-09T14:30:00Z", "label": "before refactor", "files": [ { "path": "src/api/auth.js", "hash": "sha256:abc123...", "size": 2456 } ], "totalFiles": 12, "totalSize": 34567}```## Auto-Checkpoint TriggersCheckpoints are automatically created by hooks in these situations:- Before deployment (`/deploy`)- Before PDCA iterate phase- Before bulk file operations (10+ files)## Output Format```markdown## Checkpoint Created- **ID**: chk-20260409-143000- **Label**: before refactor- **Files**: 12 tracked files- **Size**: 34.5 KBUse `/rollback restore chk-20260409-143000` to restore.```## Safety Rules1. **Always create backup** before restoring (double safety net)2. **Never delete checkpoints** automatically - user must manage3. **Warn on old checkpoints** - flag if restoring to a checkpoint older than 24 hours4. **Show diff first** - recommend `/rollback diff` before `/rollback restore`

Frequently asked questions