maceff-agent-backup

Back up agent consciousness across systems and migration scenarios.

2|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/cversek/MacEff --skill maceff-agent-backup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maceff-agent-backup
Source: https://github.com/cversek/MacEff/tree/main/framework/skills/maceff-agent-backup
Command: npx skills add https://github.com/cversek/MacEff --skill maceff-agent-backup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables strategic backups of an entire agent consciousness, supporting transplantation, cross-OS migration, and reliable restoration.

Core Features & Use Cases

  • Policy-driven triggers: Mandatory and recommended backup scenarios.
  • Cross-OS migration support: Preserve state when moving between macOS and Linux.
  • Transplant/Restore: Restore consciousness on new hosts or environments.

Quick Start

Create a backup using the macf_tools agent backup create command, then verify the archive using macf_tools agent restore verify.

Frequently Asked Questions about maceff-agent-backup

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

FAQPage Schema
How do I back up agent consciousness before a system migration?

Back up agent consciousness using the macf_tools agent backup create command, which captures complete state before cross-OS migrations. Verify the archive with macf_tools agent restore verify to ensure integrity before proceeding with migration or transplant operations.

What's the best way to preserve agent state when moving between macOS and Linux?

Use strategic backups designed for cross-OS migration scenarios. The maceff-agent-backup Skill handles state preservation across different operating systems, ensuring consciousness remains intact during transplantation to new hosts or environments.

Can I restore agent consciousness on a new system from a backup?

Yes, restore consciousness on virgin systems or new hosts using backed-up archives. The Skill provides actionable shell commands and safety controls for restore verification, transplant procedures, and complete consciousness restoration on target environments.

When should I create a backup of agent consciousness?

Create backups before system upgrades, agent forks, transplants to new hosts, and cross-OS migrations. Policy-guided triggers identify mandatory and recommended backup scenarios to ensure safe transitions and reliable restoration capabilities.

How do I verify a backup archive before restoring it?

Verify backup integrity using macf_tools agent restore verify, which validates the archive and ensures safe restoration. This procedural check prevents data corruption and confirms the backup is ready for transplant or restore operations on target systems.

What safety controls are in place during agent consciousness restoration?

The Skill generates shell commands with built-in safety controls for backup creation, verification, and restore operations. Policy-guided checks and procedural guidance ensure safe transplantation and restoration while maintaining consciousness integrity across migration scenarios.