backup-operations

Operate encrypted incremental backups and restores with passphrase custody and restore verification guidance.

26|3|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/allcolor/PawFlow-Agents --skill backup-operations-allcolor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: backup-operations
Source: https://github.com/allcolor/PawFlow-Agents/tree/main/lawassist/platform.incremental-backup.pfpdir/content/skills/backup-operations
Command: npx skills add https://github.com/allcolor/PawFlow-Agents --skill backup-operations-allcolor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Encrypted incremental backups are only as safe as the passphrase protecting them, and restores can silently fail or overwrite live data if handled carelessly. This Skill gives operators the safety rules for running incremental_backup and restore_from_backup without losing data or creating false confidence. ## Core Features & Use Cases - Passphrase Custody Guidance: Explains the scrypt-derived encryption key model and the absence of any recovery mechanism, so users understand that a lost passphrase means a permanently unrecoverable backup. - Backup Scope Rules: Identifies content that never needs backing up, such as open data already republished by public sources like the legal-kb MCP, avoiding wasted storage and upload time. - Restore Verification Checklist: Requires checking files_failed is empty before declaring success, treating manifest decrypt errors as loud stop signals, and using manifest_timestamp for point-in-time restores. - Use Case: A law firm enables nightly encrypted backups of client matter files; before trusting a restore after an accidental deletion, the operator restores an older manifest_timestamp into a separate target_path instead of overwriting /workspace. ## Quick Start Explain the passphrase risks and then walk me through restoring my encrypted backup to a separate target path without overwriting my current workspace.

Frequently Asked Questions about backup-operations

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

FAQPage Schema
How do I restore files from an encrypted incremental backup?▼

Call restore_from_backup with the same destination_service, destination_root, and backup_passphrase secret used for the backup, plus a target_path to restore into. Never restore directly onto /workspace without explicit user confirmation that overwriting current files is intended.

What happens if I lose my backup passphrase?▼

The backup becomes permanently unrecoverable because the encryption key is derived from the passphrase via scrypt with no escrow or recovery mechanism. Neither PawFlow nor the cloud provider can decrypt it, so store the passphrase offline or with a second trusted person.

How do I verify a backup restore completed successfully?▼

Check the files_restored and files_failed values reported by restore_from_backup and confirm files_failed is empty before declaring success. A manifest decrypt failure indicates a wrong passphrase or mismatched destination and should stop the process, not trigger retries.

Can I restore an older version instead of the latest backup?▼

Yes, the manifest_timestamp parameter lets you restore an earlier point in time rather than the latest state. This is useful when the most recent backup captured a mistake, such as an accidentally deleted file that an earlier manifest still references.

What files should I exclude from incremental backups?▼

Exclude anything already republished as open data by a public source, such as content reachable through the legal-kb MCP from justicelibre.org. Backing up such data wastes storage and upload time while providing zero recovery value.