sandbox-snapshot

Create rotating directory snapshots with rsync and hardlinks.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/Toqsick/MaxClaw --skill sandbox-snapshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sandbox-snapshot
Source: https://github.com/Toqsick/MaxClaw/tree/main/skills/sandbox-snapshot
Command: npx skills add https://github.com/Toqsick/MaxClaw --skill sandbox-snapshot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of rotating directory snapshots to backup GreyHack game states, tool repositories, and other workspaces, providing a way to detect changes and recover from data loss.

Core Features & Use Cases

  • Rotating Snapshots: Creates incremental snapshots using rsync and hardlinks to save space.
  • Change Detection: Generates diff reports for detecting changes between snapshots.
  • Triggers: Can be triggered by cron jobs, pre-mutation events, or manually via a script.
  • Use Case: Use this Skill to ensure that your GreyHack save files and tool repositories are backed up regularly and to quickly restore from a snapshot if needed.

Quick Start

Run the snapshot.sh script with the directory you want to snapshot and the number of snapshots to keep.

Frequently Asked Questions about sandbox-snapshot

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

FAQPage Schema
How do I create rotating directory snapshots for backup and change detection?

Rotating directory snapshots are created using rsync and hardlinks to efficiently store incremental backups. You can trigger the snapshot process manually via a script or automatically using cron jobs to regularly capture and rotate your workspace states.

How does rsync with hardlinks save space when backing up directories?

Rsync uses hardlinks to share unchanged files across multiple snapshots, meaning identical files are stored only once on disk. This mechanism allows you to retain numerous rotating snapshots without consuming duplicate storage space for unchanged data.

Can I use cron jobs to automate directory snapshots on Linux?

Yes, you can automate directory snapshots on Linux using cron job triggers. The snapshot script supports automated execution via cron, allowing you to schedule regular rsync backups without manual intervention to protect your workspaces.

What is the best way to detect file changes between directory backups?

The best way to detect file changes is by generating diff reports between snapshots. The Skill creates incremental snapshots using rsync and provides change detection reports, allowing you to quickly identify what was modified, added, or deleted.

Do I need any specific dependencies to run rsync snapshots for change detection?

You need a Linux environment with rsync installed to run these rotating snapshots. The Skill relies on standard shell scripts and rsync hardlinks to function, requiring no additional external dependencies or complex setup procedures.

When should I avoid using hardlink-based snapshots for backups?

You should avoid hardlink-based snapshots if your filesystem does not support hardlinks or if you need backups on a separate physical drive. Hardlinks only save space within the same filesystem, so cross-device backups require traditional file copying instead.