recovering-work

Restore lost files from validation snapshots and git history using tree-hashes.

3|Updated Oct 16, 2025
One-click install
npx skills add https://github.com/jdutton/vibe-validate --skill recovering-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recovering-work
Source: https://github.com/jdutton/vibe-validate/tree/main/docs/skills/recovering-work
Command: npx skills add https://github.com/jdutton/vibe-validate --skill recovering-work

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recovering lost work after git operations or validation runs can be fragile without a clear, reliable recovery workflow. This guide explains how to locate, inspect, and restore files from deterministic validation snapshots and git history.

Core Features & Use Cases

  • Locate recent validation snapshots using vv history and identify the exact tree-hash to recover.
  • Safely restore a single file or an entire directory from a tree-hash with git cat-file and git checkout, preserving prior states.
  • Handle scenarios such as deleted untracked files, accidental hard resets, crashes, or branch switches, with guidance for verification and pruning.

Quick Start

Identify the most recent valid validation snapshot with vv history, then restore the desired file using git cat-file and the appropriate tree-hash.

Frequently Asked Questions about recovering-work

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

FAQPage Schema
How do I recover deleted untracked files after a git reset or restore?

Recover deleted untracked files by locating recent validation snapshots with vv history, identifying the exact tree-hash, and restoring content using git cat-file and git checkout. This workflow retrieves lost work from deterministic snapshots in git history.

What are git validation snapshots and when do I need them for file recovery?

Validation snapshots are deterministic historical file states captured by vv snapshot. You need them when recovering wiped edits, deleted untracked files, or lost work after accidental hard resets, branch switches, or crashes where standard git history is insufficient.

How do I restore a specific file from a git tree-hash?

Restore a specific file from a tree-hash by inspecting snapshot content with git cat-file, then extracting the desired file or directory using git checkout and the appropriate tree-hash. This safely restores lost content while preserving prior states.

Can I use vv history to recover work after an accidental git hard reset?

Yes, vv history locates validation snapshots taken before the hard reset. By identifying the correct tree-hash from the snapshot history, you can restore wiped edits and lost files using git checkout, even when untracked changes were lost.

Does this git recovery workflow require any special dependencies or components?

No special dependencies are required beyond git and the vv command-line tool. The recovery workflow relies on standard git commands like git cat-file and git checkout, combined with vv history and vv snapshot for locating and verifying deterministic file states.

What should I do if git snapshot recovery is not working for lost untracked files?

If recovery is not working, verify that a validation snapshot was captured before the loss using vv history. Without a prior vv snapshot, untracked files deleted by git restore or reset cannot be recovered, as they were never committed to git history.