trash
trash ディレクトリ内のアンインストール済み Skill と agent を管理します。
skillshare trash list # インタラクティブ TUI（TTY 内）
skillshare trash list --no-tui # プレーンテキスト出力
skillshare trash restore my-skill # trash から復元
skillshare trash restore my-skill -p # project モードで復元
skillshare trash delete my-skill # trash から完全に削除
skillshare trash empty # trash を空にする
skillshare trash agents list # trash 内の agent を一覧表示
skillshare trash agents restore tutor # trash から agent を復元
skillshare trash --all list # trash 内の Skill と agent を一覧表示
使うタイミング
- 最近アンインストールした Skill や agent を復元する（7 日以内）
- trash 内の項目を完全に削除して容量を空ける
- 自動失効する前に trash の中身を確認する
インタラクティブ TUI
TTY 内では、trash list は複数選択、フィルタリング、インライン復元／削除操作を備えたインタラクティブ TUI を起動します。各項目には種別バッジが表示されます: Skill は [S]、agent は [A] です。
Trash (global) — 5 items
[ ] [S] my-skill (512 B, 2d ago)
[x] [S] old-tool (1.2 KB, 5d ago)
[ ] [A] tutor (2.0 KB, 3d ago)
[ ] [S] another (128 B, 1d ago)
─────────────────────────────────────────
Name: old-tool
Type: Skill
Trashed: 2026-02-27 14:30:05
Size: 1.2 KB
Path: ~/.local/share/skillshare/trash/old-tool_...
── SKILL.md ──────────────────────────────
---
name: old-tool
description: A helpful tool
---
# old-tool
...
↑↓ navigate / filter space select r restore(1) d delete(1) D empty q quit
--all を使う場合、または種別フィルタを指定しない場合、TUI は Skill と agent を統合し、日付順（新しい順）にソートされた 1 つのリストにまとめます。
キーバインド
| キー | 動作 |
|---|---|
↑/↓ | 項目を移動 |
←/→ | ページを変更 |
/ | フィルタモードに入る（名前の部分一致） |
Space | 現在の項目の選択を切り替え |
a | 表示中の全項目の選択を切り替え |
r | 選択した項目を復元（確認あり） |
d | 選択した項目を完全に削除（確認あり） |
D | trash をすべて空にする（選択を無視、確認あり） |
Ctrl+d/Ctrl+u | 詳細パネルを下／上にスクロール |
q/Ctrl+C | 終了 |
確認モードでは: y/Enter で確定、n/Esc でキャンセルします。
バッチ操作
複数の項目が選択されている場合、r と d はすべての項目に対して動作します。一部の項目が失敗した場合（例: 復元しようとした Skill と同じ名前が既に source に存在する場合）、TUI は残りの項目の処理を続行し、結合された結果を表示します。
Restored 2 item(s) Failed: my-skill: already exists
--no-tui を使うと TUI をスキップし、代わりにプレーンテキストを出力します。
skillshare trash list --no-tui # プレーンテキスト出力
skillshare trash list --no-tui | less # 手動でページャーにパイプする
種別フィルタ
デフォルトでは、trash は Skill に対して動作します。agent を対象にするには agents 位置引数キーワードを、両方を含めるには --all を使用してください。
skillshare trash list # Skill のみ（デフォルト）
skillshare trash agents list # agent のみ
skillshare trash --all list # Skill と agent の両方
skillshare trash agents restore tutor # trash 内の agent を復元
skillshare trash agents empty # agent の trash のみを空にする
サブコマンド
list（エイリアス: ls）
trash 内の全項目を表示します。ターミナルではインタラクティブ TUI を起動し、--no-tui を指定した場合や非 TTY の場合はプレーンテキストを出力します。
skillshare trash list
skillshare trash agents list
skillshare trash --all list --no-tui
プレーンテキスト出力:
Trash
my-skill (1.2 KB, 2d ago)
old-helper (800 B, 5d ago)
2 item(s), 2.0 KB total
Items are automatically cleaned up after 7 days
restore
trash 内の最新バージョンを source ディレクトリに復元します。
skillshare trash restore my-skill
skillshare trash agents restore tutor
✓ Restored: my-skill
ℹ Trashed 2d ago, now back in ~/.config/skillshare/skills
ℹ Run 'skillshare sync' to update targets
agent の場合、復元時のヒントには代わりに skillshare sync agents が提案されます。
同じ名前の項目が既に source に存在する場合、復元は失敗します。先に既存の項目をアンインストールするか、別の名前を使用してください。
delete（エイリアス: rm）
trash から単一の項目を完全に削除します。
skillshare trash delete my-skill
skillshare trash agents delete tutor
✓ Permanently deleted: my-skill
empty
trash 内のすべての項目を完全に削除します（確認プロンプトあり）。
skillshare trash empty
skillshare trash agents empty
⚠ This will permanently delete 3 item(s) from trash
Continue? [y/N]: y
✓ Emptied trash: 3 item(s) permanently deleted
Backup vs Trash
この 2 つの安全機構は、それぞれ異なるものを保護します。
| backup | trash | |
|---|---|---|
| 保護対象 | target ディレクトリ（sync のスナップショット） | source の Skill と agent（アンインストール） |
| 保存場所 | ~/.local/share/skillshare/backups/ | ~/.local/share/skillshare/trash/（Skill）、.../trash/agents/（agent） |
| トリガー | sync, target remove | uninstall |
| 復元方法 | skillshare restore <target> | skillshare trash restore <name> |
| 自動クリーンアップ | 手動（backup --cleanup） | 7 日 |
オプション
| フラグ | 説明 |
|---|---|
agents | 位置引数キーワード — Skill の代わりに agent を対象にする |
--all | Skill と agent の両方を含める |
--no-tui | インタラクティブ TUI を無効化し、プレーンテキスト出力を使用 |
--project, -p | project レベルの trash を使用（.skillshare/trash/） |
--global, -g | グローバルな trash を使用 |
--help, -h | ヘルプを表示 |
自動クリーンアップ
期限切れの trash 項目（7 日以上経過したもの）は、uninstall または sync を実行すると自動的にクリーンアップされます。cron やスケジュールされたタスクは不要です。