Skip to main content

restore

Restore a target from a backup.

skillshare restore claude                              # Latest backup
skillshare restore claude --from 2026-01-19_10-00-00 # Specific backup
skillshare restore claude --dry-run # Preview

What Happens

┌─────────────────────────────────────────────────────────────────┐
│ skillshare restore claude │
└─────────────────────────────────────────────────────────────────┘


┌─────────────────────────────────────────────────────────────────┐
│ 1. Find latest backup for claude │
│ → backups/2026-01-20_15-30-00/claude/ │
└─────────────────────────────────────────────────────────────────┘


┌─────────────────────────────────────────────────────────────────┐
│ 2. Remove current target directory │
│ → ~/.claude/skills/ (removed) │
└─────────────────────────────────────────────────────────────────┘


┌─────────────────────────────────────────────────────────────────┐
│ 3. Copy backup to target │
│ → ~/.claude/skills/ (restored) │
└─────────────────────────────────────────────────────────────────┘

Options

FlagDescription
--from <timestamp>Restore from specific backup
--forceOverwrite without confirmation
--dry-run, -nPreview without making changes

Finding Backups

List available backups:

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

Examples

# Restore from latest backup
skillshare restore claude

# Restore from specific backup
skillshare restore claude --from 2026-01-19_10-00-00

# Preview restore
skillshare restore claude --dry-run

# Force restore (skip confirmation)
skillshare restore claude --force

After Restoring

After restore, your target will have regular directories instead of symlinks. To re-sync:

skillshare restore claude    # Restore backup
skillshare sync # Re-sync from source (creates symlinks)

Or keep the restored state:

skillshare restore claude    # Restore backup
# Done - skills are now local copies

Use Cases

Accidental Deletion

If you accidentally deleted a skill:

skillshare restore claude --from 2026-01-19_10-00-00

Reverting Changes

If a sync went wrong:

skillshare restore claude  # Go back to pre-sync state

Testing

Restore to test old skill versions:

skillshare restore claude --from 2026-01-15_10-00-00
# Test old skills...
skillshare sync # Return to current state
  • backup — Create and manage backups
  • sync — Re-sync after restore