# Backup Vault

> Create a dated zip backup of the Obsidian vault and rotate old backups on a grandfather-father-son schedule (14 daily, 5 weekly, 12 monthly, 5 yearly). Use when asked to back up the vault, make a snapshot, or run/prune vault backups.

- **Type:** Skill
- **Install:** `agentstack add skill-fredoliveira-agents-backup-vault`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fredoliveira](https://agentstack.voostack.com/s/fredoliveira)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fredoliveira](https://github.com/fredoliveira)
- **Source:** https://github.com/fredoliveira/agents/tree/main/skills/backup-vault

## Install

```sh
agentstack add skill-fredoliveira-agents-backup-vault
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Vault backup & rotation

## Purpose

Keep a rolling set of zip snapshots of the vault in `~/Documents/obsidian/backups`,
pruned to a grandfather-father-son (GFS) retention schedule so the backup folder
stays bounded instead of growing forever.

The actual work is done by `backup.sh` (next to this file) — the logic is
deterministic, so run the script rather than reimplementing it by hand.

## Retention schedule

A backup is **kept** if any tier wants it; everything else is deleted.

| Tier    | Rule                                              |
| ------- | ------------------------------------------------- |
| Daily   | every backup from the last **14 days**            |
| Weekly  | newest backup of each of the **5** most recent ISO weeks |
| Monthly | newest backup of each of the **12** most recent months   |
| Yearly  | newest backup of each of the **5** most recent years     |

Tunable at the top of `backup.sh` (`DAILY_DAYS`, `WEEKLY_KEEP`, `MONTHLY_KEEP`, `YEARLY_KEEP`).

## What gets backed up

- The full vault at `~/Documents/obsidian/umwelt`, **including** `.obsidian`
  (themes, plugins, settings) so a restore reproduces the exact setup.
- Excluded: `.DS_Store`, `.Trash/`, and the backup directory itself.
- Archives are named `umwelt-YYYY-MM-DD.zip` and contain a top-level `umwelt/`
  folder, so restoring is just `unzip umwelt-.zip`.

## Instructions

1. Run the script:
   ```sh
   bash ~/.claude/skills/backup-vault/backup.sh
   ```
   - Preview without changing anything: `bash .../backup.sh --dry-run`
   - Override paths if needed: `VAULT_DIR=... BACKUP_DIR=... bash .../backup.sh`
2. Report the summary line (how many backups were created / kept / pruned) and
   the resulting archive size.

The script is **idempotent per day**: at most one backup is created per calendar
date, so it's safe to run repeatedly. Running it both creates today's snapshot
**and** applies retention in one pass.

## Notes

- This is local only. To replicate offsite, `rsync` the `backups/` directory to
  the remote target after running the script, e.g.
  `rsync -a --delete ~/Documents/obsidian/backups/ :obsidian-backups/`.
  Because retention deletes files locally, use `--delete` so the remote mirrors
  the same pruned set.
- For unattended daily runs, schedule the script (launchd/cron, or the
  `/schedule` skill). Nothing in the script needs an interactive session.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fredoliveira](https://github.com/fredoliveira)
- **Source:** [fredoliveira/agents](https://github.com/fredoliveira/agents)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fredoliveira-agents-backup-vault
- Seller: https://agentstack.voostack.com/s/fredoliveira
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.