Skill

claude-vigil

File checkpoint and recovery — auto-quicksaves before destructive commands, INVOKE before implementing a plan or starting risky multi-file changes. Also use when user asks to undo changes or compare current state to a prior checkpoint.

From claude-vigil

Install

Run in your terminal

npx claudepluginhub vvkmnn/claude-emporium-beta --plugin claude-vigil

Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

138.7k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

bmad-help

Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.

bmad-pro-skills

43.8k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitMar 21, 2026

Actions

View Source View Plugin View on GitHub View README

Hook

When

Action

PreToolUse(Bash)

Destructive command detected

Auto-quicksaves affected files (rm, mv, git reset, etc.)

Command

Description

/save-vigil <name> [files]

Create a named file checkpoint

/restore-vigil [name]

Restore files from a checkpoint

Workflows

Before Implementing a Plan

After exiting plan mode, before writing any code:

vigil_save(name="before-<plan-name>") — snapshot the project

Implement the plan

If something goes wrong: vigil_diff(name="before-<plan-name>") then vigil_restore(name="before-<plan-name>")

Before Risky Changes

Before refactors or multi-file changes:

vigil_save(name="before-refactor") — named checkpoint

Make changes safely

If something breaks: vigil_diff first, then vigil_restore

Recovery

Always diff before restoring:

vigil_list() — see available checkpoints

vigil_diff(name="checkpoint") — preview what would change

vigil_restore(name="checkpoint") — restore files

Displaced files are preserved in .claude/vigil/artifacts/

Storage Management

Vigil has 3 named slots + 1 rotating ~quicksave:

~quicksave is ONE rotating slot — overwritten on each destructive command

Named checkpoints persist until deleted

Run vigil_list() periodically to check capacity

When nearing capacity (2+ named checkpoints), offer to clean up the oldest with vigil_delete(name="oldest")

vigil_restore preserves displaced files in .claude/vigil/artifacts/ — ask the user before cleaning those up

Tool

Purpose

vigil_save

Create named checkpoint (SHA-256 + gzip dedup)

vigil_list

List available checkpoints with metadata

vigil_diff

Preview changes since checkpoint

vigil_restore

Restore files from checkpoint

vigil_delete

Remove a checkpoint and free storage

Vigil Plugin

File recovery. Saves checkpoints before dangerous operations, diffs changes, restores files safely.

Hooks

Hook	When	Action
PreToolUse(Bash)	Destructive command detected	Auto-quicksaves affected files (rm, mv, git reset, etc.)

Token cost: 0 on safe commands, ~30 on destructive.

Commands

Command	Description
`/save-vigil <name> [files]`	Create a named file checkpoint
`/restore-vigil [name]`	Restore files from a checkpoint