Files
skillshare/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/trash.md
T
Willie cf36965cea feat(website): add zh-Hant/zh-Hans/ja/ko locales with initial docs translation
Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.

Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
2026-09-20 11:08:48 +08:00

7.5 KiB
Raw Blame History

sidebar_position
sidebar_position
4

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 やスケジュールされたタスクは不要です。

関連項目

  • uninstall — Skill を削除(trash へ移動)
  • backup — target ディレクトリをバックアップ
  • restore — バックアップから target を復元