メインコンテンツまでスキップ

バックアップと復元

Skill を保護し、ミスから復旧します。

概要​

skillshare は自動バックアップを維持し、手動のバックアップ/復元コマンドも提供します。

自動バックアップ​

バックアップは以下の前に自動的に作成されます。

  • skillshare sync（Skill の Target と Agent の Target）
  • skillshare sync agents（Agent の Target のみ）
  • skillshare target remove

場所: ~/.local/share/skillshare/backups/<timestamp>/（Agent のバックアップは通常の <target>/ ディレクトリの隣に <target>-agents/ として表示されます）。

範囲: ローカルの Target の内容のみが対象です。Merge モードのシンボリックリンクは Source を指しているためスキップされます — sync がそれらを再作成します。詳しくは What Gets Backed Up を参照してください。

手動バックアップ​

すべての Target​

skillshare backup

特定の Target​

skillshare backup claude

プレビュー​

skillshare backup --dry-run

バックアップの一覧表示​

skillshare backup --list

出力例:

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

復元​

最新のバックアップから​

skillshare restore claude

特定のバックアップから​

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

プレビュー​

skillshare restore claude --dry-run

復元の仕組み​

注意: 復元後、Target にはシンボリックリンクではなく実ファイルが含まれます。シンボリックリンクを再構築するには skillshare sync を実行してください。

古いバックアップのクリーンアップ​

skillshare backup --cleanup

設定された保持期間より古いバックアップを削除します。保持処理はすでに sync のたびに自動実行されているため、これはオンデマンドでの整理専用です。

スナップショットが使用しているディスク容量を確認するには:

du -sh ~/.local/share/skillshare/backups
skillshare backup --cleanup --dry-run   # 削除対象をプレビュー

バックアップの範囲が .gitignore や ignore: とどう異なるかは、Backups & Disk Space を参照してください。

復旧シナリオ​

シンボリックリンク経由で誤って Skill を削除した​

# git が初期化されている場合（推奨）
cd ~/.config/skillshare/skills
git checkout -- deleted-skill/

# またはバックアップから復元
skillshare restore claude
skillshare sync

Sync モードを間違えた​

skillshare restore claude
skillshare target claude --mode merge
skillshare sync

最近の変更を取り消したい​

skillshare backup --list
skillshare restore claude --from <earlier-timestamp>

Agent を復旧する​

Agent は独自のバックアップエントリ（<target>-agents）を持ち、Skill と同じフローに従います。

# 手動での Agent バックアップ
skillshare backup agents claude

# 最新から復元
skillshare restore agents claude

# 特定のタイムスタンプから復元
skillshare restore agents claude --from 2026-01-19_10-00-00

Project mode では Agent のみバックアップ・復元が可能です — skillshare backup -p agents は動作しますが、単純な skillshare backup -p はエラーになります。Project mode のルールについては backup を参照してください。

ベストプラクティス​

リスクのある操作の前に​

skillshare backup

大きな変更の後に​

skillshare push -m "Major update"  # Git バックアップ

週次メンテナンス​

skillshare backup --cleanup

バックアップとしての Git​

Git は追加のバックアップレイヤーを提供します。

# 削除された Skill を復旧
cd ~/.config/skillshare/skills
git checkout -- deleted-skill/

# 履歴を確認
git log --oneline

# 以前のコミットに復元
git checkout <commit-hash> -- specific-skill/

関連項目​