blackbox

Capture file snapshots before modifications and restore previous versions by hash.

Updated Dec 14, 2025

Search Tags:#automation #debugging #version control #data protection #disaster recovery #snapshot #file history

One-click install

npx skills add https://github.com/pproenca/dot-claude --skill blackbox

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: blackbox
Source: https://github.com/pproenca/dot-claude/tree/main/plugins/blackbox/skills/blackbox
Command: npx skills add https://github.com/pproenca/dot-claude --skill blackbox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Accidental file modifications, deletions, or unexpected changes can lead to data loss and difficult recovery, especially without robust version control or immediate backups.

Core Features & Use Cases

Automatic File Snapshots: Captures file content before modifications (PreToolUse events) for disaster recovery and historical tracking.
Event Logging: Records user prompts and session boundaries, providing a comprehensive context of activity.
File Restoration: Easily query modification history and restore previous file versions by hash or pattern, recovering from accidental edits.
Use Case: If you accidentally delete a critical section of code, you can use Blackbox to list recent snapshots of that file and restore a previous working version.

Quick Start

Use the blackbox skill to list the last 5 snapshots of 'my_important_script.py'.