Skip to main content

backup

Create, list, and manage backups of target directories.

skillshare backup              # Backup all targets
skillshare backup claude       # Backup specific target
skillshare backup --list       # List all backups
skillshare backup --cleanup    # Remove old backups

Automatic Backups​

Backups are created automatically before:

  • skillshare sync
  • skillshare target remove

Location: ~/.config/skillshare/backups/<timestamp>/

Commands​

Create Backup​

skillshare backup              # All targets
skillshare backup claude       # Specific target
skillshare backup --dry-run    # Preview

List Backups​

skillshare backup --list
All backups (15.3 MB total)
  2026-01-20_15-30-00  claude, cursor     4.2 MB  ~/.config/.../2026-01-20_15-30-00
  2026-01-19_10-00-00  claude             2.1 MB  ~/.config/.../2026-01-19_10-00-00
  2026-01-18_09-00-00  claude, cursor     4.0 MB  ~/.config/.../2026-01-18_09-00-00

Cleanup Old Backups​

skillshare backup --cleanup           # Remove old backups
skillshare backup --cleanup --dry-run # Preview cleanup

Default cleanup policy:

  • Keep last 10 backups
  • Remove backups older than 30 days
  • Cap total size at 100 MB

Options​

FlagDescription
--list, -lList all backups
--cleanup, -cRemove old backups
--target, -t <name>Target specific backup
--dry-run, -nPreview without making changes

Backup Structure​

~/.config/skillshare/backups/
├── 2026-01-20_15-30-00/
│   ├── claude/
│   │   ├── skill-a/
│   │   └── skill-b/
│   └── cursor/
│       ├── skill-a/
│       └── skill-b/
└── 2026-01-19_10-00-00/
    └── claude/
        └── ...

What Gets Backed Up​

  • Regular directories in targets (actual skill files)
  • Not backed up: Symlinks (they just point to source)

This means:

  • In merge mode: Only local-only skills are backed up
  • In symlink mode: Nothing is backed up (entire dir is symlink)