Files
skillshare/website/docs/commands/restore.md
T
Willie 8e58cc7383 docs: add missing flags to diff and restore command pages
diff.md: add Options table (--target/-t, --project/-p, --global/-g)
restore.md: document -f shorthand for --from
2026-02-21 21:12:51 +08:00

2.3 KiB

sidebar_position
sidebar_position
3

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

When to Use

  • A sync went wrong and you need to revert a target to its previous state
  • You accidentally removed skills from a target

What Happens

flowchart TD
    CMD["skillshare restore claude"]
    FIND["1. Find latest backup"]
    REMOVE["2. Remove current target"]
    COPY["3. Copy backup to target"]
    CMD --> FIND --> REMOVE --> COPY

Options

Flag Description
--from, -f <timestamp> Restore from specific backup
--force Overwrite without confirmation
--dry-run, -n Preview 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

See Also

  • backup — Create and manage backups
  • sync — Re-sync after restore