mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
ASCII box-drawing characters (┌─┐│└─┘) render inconsistently on
Windows due to monospace font width differences. Replace all 30+
diagrams across docs with Mermaid flowcharts rendered as SVG.
- Add Mermaid handDrawn config (Rough.js sketchy style, seed 42)
- Add CSS fix for foreignObject overflow clipping in handDrawn mode
- Convert supported-targets grid to HTML with anchor navigation
- Simplify all node labels to short, readable single-line text
- Strip redundant %%{init}%% directives (covered by global config)
3.0 KiB
3.0 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
Backup & Restore
Protect your skills and recover from mistakes.
Overview
Skillshare maintains automatic backups and provides manual backup/restore commands.
flowchart LR
T1["TARGETS"] -- backup --> B["~/.local/share/skillshare/backups/"]
B -- restore --> T2["TARGETS"]
Automatic Backups
Backups are created automatically before:
skillshare syncskillshare target remove
Location: ~/.local/share/skillshare/backups/<timestamp>/
Manual Backup
All targets
skillshare backup
Specific target
skillshare backup claude
Preview
skillshare backup --dry-run
List Backups
skillshare backup --list
Example output:
Backups
─────────────────────────────────────────
2026-01-20_15-30-00/
claude/ 5 skills, 2.1 MB
cursor/ 5 skills, 2.1 MB
2026-01-19_10-00-00/
claude/ 4 skills, 1.8 MB
Restore
From latest backup
skillshare restore claude
From specific backup
skillshare restore claude --from 2026-01-19_10-00-00
Preview
skillshare restore claude --dry-run
What Restore Does
flowchart TD
TITLE["skillshare restore claude"]
S1["1. Find latest backup"]
S2["2. Remove current target"]
S3["3. Copy backup to target"]
TITLE --> S1 --> S2 --> S3
Note: After restore, the target contains real files (not symlinks). Run skillshare sync to re-establish symlinks.
Cleanup Old Backups
skillshare backup --cleanup
Removes backups older than the configured retention period.
Recovery Scenarios
Accidentally deleted a skill through symlink
# If git is initialized (recommended)
cd ~/.config/skillshare/skills
git checkout -- deleted-skill/
# Or restore from backup
skillshare restore claude
skillshare sync
Messed up sync mode
skillshare restore claude
skillshare target claude --mode merge
skillshare sync
Want to undo recent changes
skillshare backup --list
skillshare restore claude --from <earlier-timestamp>
Best Practices
Before risky operations
skillshare backup
After major changes
skillshare push -m "Major update" # Git backup
Weekly maintenance
skillshare backup --cleanup
Git as Backup
Git provides an additional backup layer:
# Recover deleted skill
cd ~/.config/skillshare/skills
git checkout -- deleted-skill/
# See history
git log --oneline
# Restore to previous commit
git checkout <commit-hash> -- specific-skill/
See Also
- backup — Backup command reference
- restore — Restore command reference
- trash — Soft-delete management
- Troubleshooting — When things go wrong