Files
skillshare/website/docs/reference/commands/backup.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00

104 lines
2.5 KiB
Markdown

---
sidebar_position: 2
---
# backup
Create, list, and manage backups of target directories.
```bash
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
```bash
skillshare backup # All targets
skillshare backup claude # Specific target
skillshare backup --dry-run # Preview
```
### List Backups
```bash
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
```bash
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)
- **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)
## See Also
- [restore](/docs/reference/commands/restore) — Restore from backup
- [sync](/docs/reference/commands/sync) — Auto-creates backups
- [target remove](/docs/reference/commands/target) — Auto-creates backups