Files
skillshare/website/docs/reference/commands/backup.md
T
Willie ba894dc5a6 docs: update website docs for v0.16.* features
Cross-validate and fix docs against source code:
- diff: fix merge mode description (no manifest-based orphans)
- backup: fix "What Gets Backed Up" (symlinks now followed)
- restore: add interactive TUI section and --no-tui flag
- trash: add SKILL.md preview, ls/rm aliases
- version: fix example, add Homebrew-aware update notifications
- install: add shell glob protection tip
- update: add basename matching note for glob patterns
- uninstall: add top-level-only matching note
- README: consolidate 0.16.* highlights
2026-03-02 02:23:50 +08:00

2.6 KiB

sidebar_position
sidebar_position
2

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

When to Use

  • Create a manual backup before risky changes
  • List existing backups to check recovery options
  • Clean up old backups to free disk space

Automatic Backups

Backups are created automatically before:

  • skillshare sync
  • skillshare target remove

Location: ~/.local/share/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 500 MB

Options

Flag Description
--list, -l List all backups
--cleanup, -c Remove old backups
--target, -t <name> Target specific backup
--dry-run, -n Preview without making changes

Backup Structure

~/.local/share/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)
  • Per-skill symlinks in merge-mode targets are resolved and followed — the real content is backed up

This means:

  • In merge mode: All skills are backed up (symlinks resolved, local copies included)
  • In copy mode: All managed skill directories are backed up
  • In symlink mode: Nothing is backed up (entire directory is a single symlink)

See Also